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Section 1 


Introduction 


The TMS320 family consists of three generations of digital signal processors. 
The first generation includes several processors such as the TMS320C10, 
TMS320C15, TMS320C17, TMS320E15, TMS320E17, and 
TMS320C14/E14 (CPU only). The TMS32020 and TMS320C25 are the 
second-generation processors. The TMS320C30 is the _ third-generation 
processor. Device user’s guides are available from your local sales office. 


Four of the first-generation processors mentioned above are new compatible 
CMOS additions to the line of industry-leading TMS320 digital signal 
processors (DSP). The TMS320C15 and its EPROM version, the 
TMS320E15, incorporate a TMS320C10 CPU and feature double the on-chip 
RAM (from 144 to 256 words) and 2.5 times the on-chip program memory 

(from 1.5K to 4K words of ROM/EPROM). The TMS320C17 and 
TMS320E17 also offer this larger on-chip memory space of 256 words of 
ae and 4K words of ROM/EPROM, plus two serial ports and a coprocessor 
interface. 


The TMS320 Simulators are software programs that simulate operation of the 
TMS320 family of high-performance digital signal processors for effective 
software development. This manual includes information for the TMS320C10 
Simulator, TMS32020 Simulator, and the TMS320C25 Simulator. The 
TMS320C10 Simulator can be used for simulation of all the first-generation 
processors. 


The TMS320 Simulators are currently available on a 1600 BPI magnetic tape 
for the VAX/VMS' operating system and on a 5 1/4-inch floppy disk for the 
Tl PC/MS-DOS2 and IBM PC/PC-DOS3 operating systems. The PC config- 
uration requires a minimum of 512K words of RAM for the the second gener- 
ation Simulators. 


A TMS320 hotline is available to assist you with technical questions about 
TMS320 family products or development tools. The phone number is 
713-274-2320. 


Topics in this section include: 


Section Page 
1.1 TMS320 Simulator Description Seana etic Garett eessu tes aatdecsgieiete Antes 1-2 
Vaid. RCV FOQtUVOS posscrcnctaslibicessizdsdriavcs iaayasiaeasaanomanaaasoceoueatneeiaetetmenacstataes 1-3 
1.3 Style and Symbol Conventions ..........ccccccccccccecsee tence eeteeeeeeeeeescteeeeanens 1-4 
1.4 How to Use This Manual ................ccccccccscssssseseeeceseeeeseeeeececesuceeeusenanees 1-5 


VAX and VMS are trademarks of Digital Equipment Corporation. 
MS is a trademark of Microsoft, Incorporated. 


{BM and PC-DOS are trademarks of International Business Machines Corporation. 
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Introduction - TMS320 Simulator Description 


1.1 TMS320 Simulator Description 
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‘Each of the three TMS320 Simulator software programs simulate TMS320 


operation. The simulators allow program verification and monitoring of the 
state of the TMS320. Simulation speed is on the order of thousands of in- 
structions per second (VAX/VMS) or manarees of instructions per second 
(TI/IBM PC runnning MS/PC-DOS). + 


The simulators use TMS320 object code, produced by the TMS320 Macro 
Assembler/Link Editor. Input and output files may be associated with the port 
addresses of the I/O instructions in order to simulate |/O devices connected 
to the processor. Each interrupt flag can be set periodically at a user-defined 
interval for simulating an interrupt signal. Before initiating program execution, 
breakpoints may be defined and the trace mode set. 7 


During program execution, the internal registers and memory of the simulated 
TMS320 are modified as each instruction is interpreted by the host computer. 
Execution is suspended when one of the following conditions exists: 


1) A breakpoint or error is encountered. 
2)  A-branch to ‘self’ is detected. 
3) Execution is halted. 


Once program execution is suspended, the internal registers and both program 
and data memories can be inspected and/or modified. The trace memory can 
also be displayed. A record of the simulation session can be maintained in a 
journal file so that it may be re-executed to regain the same machine state 
during another simulation session. 3 


Introduction - Key Features 


1.2 Key Features 


These key features highlight simulator flexibility for effective software devel- 
opment: 


® Simulation of the TMS320 microprocessors 
= Teaonoe O and other first generation processors 


7 TMS320C25 
@ Interrupt generation at user-specified intervals 


@ File-associated 1/O with 8 ports (TMS320C10) or 16 ports (TMS32020 
and TMS320C25) 


@ Programmable breakpoints on: 
= Instruction acquisition 
= Memory reads and writes (data or program) 
- Data patterns on the data-bus or the program-bus 
= Error conditions 


@ Trace on: 
= Accumulator 
- Program counter 
= Auxiliary registers 


Single-stepping of instructions 


@ Data and program memory modification and display: 
- Change an entire block at any time _ 
= Initialize memory before a program is loaded 


Modification and inspection of registers 
@ Timing analysis relative to clock rate 


Error messages for: 
—- Illegal opcodes 
= Invalid data entry 


@ Execution of commands from a journal file 
Save-states for restarting simulation (TMS320C25) 
® File associated sy port for transmission and reception of ASCII data 


files (TMS320C25 


Note: 


The TMS320C15, TMS320E15, TMS320C17, and TMS320E17 each have 
256 words of RAM and 4K words of ROM, unlike the other first-genera- 
tion processors, which have 144 words of RAM and 1.5K of ROM. When 


using the TMS320C10 Simulator to simulate these four processors, enter 
the ERAM command at the command prompt. This will expand the RAM 
pony 144 words to 256 words, and the ROM from 1.5K words to 4K 
words. 
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1.3 Style and Symbol Conventions 
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These style and symbol conventions are Poe to Rissent information clearly 
and concisely: — 


The symbol <CR> indicates that a carriage return (or Enter key) should 
be pressed. 


Hexadecimal values are preceded by a greater than (>) sign. 
Screen displays are shown ina Special font. 


User inputs (responses) are underscored. 
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1.4 How to Use This Manual 


This user’s guide is a reference for development engineers who have an un- 
derstanding of TMS320 assembly language and a background knowledge of 
the TMS320C10, TMS32020, or TMS320C25 microprocessor. See the 
TMS320C1x User's Guide and the TMS320C10 Assembly Language Pro- 
grammer's Guide, or the TMS320C2x Second-Generation User's Guide for 
more information. 


The following lists each section and briefly describes the section contents. 


Section 2 - Installation and Execution Verification. Installation 
and execution verification procedures for the VAX/VMS TMS320 Sim- 
ulator and the IBM PC/PC-DOS and TI PC/MS-DOS TMS320 Simula- 
tor. Entering commands and loading a file. 


Section 3 - Simulator Commands. Control operations unique to the 
VAX/VMS and MS/PC-DOS operating systems. A command set sum- 
mary grouped by function. Individual descriptions of each command. 


Section 4 - Sample Debugging Sessions. Debugging examples for 
the three simulators to demonstrate the finding and correcting of pro- 
gram errors. 


Appendix A - Simulator Stop Codes. Definitions of run-time stop 
codes that can occur during program execution. 
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Section 2 


Installation and Execution Verification 


This section describes the simulator installation and verification procedures. 
The TMS320 Simulator can be installed on the VAX/VMS or the TI/IBM 
MS/PC-DOS operating systems. Note that the TMS320C10 Simulator re- 
quires 256K words of memory, the TMS32020 requires 512K words, and the 
TMS320C25 requires 640K words (a simulator with limited DATA memory 
arrays will run within 512K words of memory). 


Two methods verify that a working TMS320 Simulator has been installed 
correctly. Method 1 consists of entering a short series of commands from the 
keyboard and checking for the desired result. In Method 2, an absolute, 
tagged, and linked (if necessary) object file is loaded into the simulator via the 
L (load) command. 


The first part of both verification methods is the same. Because the proce- 
dures in the verification methods differ according to the device, execution 
verification for the TMS320C10 and the TMS32020/TMS320C25 are pre- 
sented in separate subsections. 


Topics in this section include: 


Section Page 
2.1 VAX/VMS TMS320 Simulator Installation oo... cee eeesseeeseeeeees 2-2 
2.2. TI/IBM MS/PC-DOS TMS320 

Simulator INStallatiOnN: scstsecisesccichciiasoievesescenesvvedseateintceccdacseorboeutecelawns 2-5 
2.3 Command Line Entries (TMS32020/C25) ooo eect eeeeeeeeees 2-6 
2.4 TMS320C10 Execution Verification ........cccccccccceeccceessenseeeeeeeesecseeeesees 2-8 
2.5 TMS32020/C25 Execution Verification ....c.ccceccecccseeceseseseeeeneaes 2-13 


Note: 


The TMS320C10 simulator program memory can only be loaded with 
ASCIl tagged object files with an absolute origin. However, the 


TMS32020/C25 simulators can be loaded with Common Object File For- 
mat (COFF) files, as well as ASCII tagged object files with an absolute 
Origin. 
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Installation/Execution - VAX/VMS 


2.1 VAX/VMS TMS320 Simulator Installation’ 


In the following pathnames, <userid> refers to the name of a directory; for 
example, DUA2:[<userid>]. In the examples, MFAO is the tape drive name 
and DUA2 is the hard disk drive name. Tape drive and disk drive names may 
differ. Consult your system manager for the correct device names. 


2.1.1. TMS320C10 Simulator — 
® Restore the simulator from tape to directory. | 


1) Place the distribution tape on a tape drive and enter these com- 
mands: 


ALLOC MFAQ: <CR> 
MOUNT MFAO:SIM320 <CR> 


To indicate a successful mount, the screen displays: 
SIM320 MOUNTED ON MFAO 
2) Read the SIM320 saveset from the tape: 


CREATE/DIR <simulator directory> <CR> 
SET DEFAULT <simulator directory> <CR> 
BACKUP/VERIFY/LOG MFAO:SIM320.BCK *.*;* <CR> 


The SIM320 saveset is now copied into your directory, with sub- 
directory structure maintained. 


3) | Dismount and deallocate the tape: 
DISMOUNT MFAQ: <CR>_ 
DEALLOCATE MFAQ: <CR> 


7] Execute the simulator by entering the following command: 
SIM <CR> | 


The system should now be executing the simulator, and the initial sim- 
ulator screen should be displayed. 
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2.1.2 TMS32020 and TMS320C25 Simulators 


@ Restore the simulators from tape to disk. 


1) 


2) 


3) 


Place the distribution tape on a tape drive and enter these com- 
mands at the terminal: 


ALLOCATE MFAOQ: <CR> 

MOUNT MFAO:SIM25 <CR> 

To indicate a successful mount, the screen displays: 
SIM25 MOUNTED ON MFAO 


To read the SIM25 saveset from the tape, note that the TMS32020 
Simulator is included in this saveset, enter: 


CREATE/DIR <sSimulator directory> <CR> 

SET DEFAULT <simulator directory> <CR> 
BACKUP/VERIFY/LOG MFA0O:SIM25.BCK *.*;* <CR> 
To dismount and deallocate the tape enter: 

DISMOUNT MFAO: <CR> 

DEALLOCATE MFAQ: <CR> 


® Execute the TMS32020/C25 Simulator by the following procedure: 


1) 


2) 


3) 


To make the simulator available for a number of users, the System 
manager may wish to make a system assignment similar to the 
following. 


S SIM25 :== S$l<system-tools-directory>]sim25.exe 


This system assignment allows the SIM25.EXE file and the asso- 
ciated SCREEN.DAT files to be placed in the system-too/s-direc- 
tory in order to properly invoke the simulator. 


The user may also wish to add the following line to the LOGIN. 
COM file. 


S$ DEFINE IPCDIR [<user-tools-directory> ] 


This statement will force the simulator to search for the 
SCREEN.DAT file in some other user directory if this file cannot 
be found in the current execution directory. 


Another option for executing the simulator is to add the following 
lines in the user’s LOGIN.COM file. 


S SIM25 :== S[<directory-for-simulator>]sim25.exe 
Ss DEFINE IPCDIR [<directory-for-simulation>] 


For this second option, the SIM25.EXE and SCREEN.DAT files 
must be in the directory-for-simulation. \f IPCDIR is not defined, 
then the SCREEN.DAT file must be in the current default directory. 
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4) Either of these options allow you to begin running the simulator 
by entering: 


RUN SIM25  <CR> 


The system should now be executing the simulator, and the initial simulator 
screen should be displayed. 


The simulator will initially be in the TMS320C25 mode as indicated at the 
right top of the screen display. To enter the TMS32020 simulator, please refer 
to the SIM command in the Simulator Commands section of this manual. 


Note: 


Some customers have reported problems running VMS programs that 
were generated under the VMS operating system earlier than 4.5 version. 
If the SIM25.EXE does not run, we have provided a way for you to re- 


generate SIM25 on your VMS system. To rebuildSIM25.EXE, type 
@Q@LINKSIM 


We recommend that you rebuild SIM25 only if the simulator does not run. 


Installation/Execution - MS/PC-DOS 


2.2 TI/IBM MS/PC-DOS TMS320 Simulator Installation 


These instructions are for hard disk systems and dual floppy drive systems. 
To install the TMS320C10, TMS32020, or the TMS320C25 Simulator, follow 
these steps: 


e Make a backup diskette of the simulator. 


e On hard disk systems, copy the simulator onto the hard disk. Enter: 
1) COPY A:*.* C:*.*/V  <CRD> 


@ For the TMS32020/C25 simulator the user should create (or modify) a 
CONFIG.SYS file. 


1) if using an IBM PC, this file should contain the lines: 


DEVICE=ANSI.SYS 
FILES=20 


2) If using the TI PC, this file should contain the lines: 
FILES=20 


After the user has re-booted the PC once, the new CONFIG.SYS file will 
take effect permanently. 


S Execute the simulator. 
1) For TMS320C10 execution, enter: 
SIM <CR> 
2) For TMS32020/C25 execution, enter: 
SIM25 <CR> for the IBM PC 
SIM25T <CR> for the TI PC. 


The system should now be executing the simulator,and the initial simulator 
screen should be displayed. 


The simulator will initially be in the TMS320C25 mode as indicated at the 
right top of the screen display. To enter the TMS32020 simulator, please refer 
to the SIM command in the Simulator Commands section of this manual. 


Note: 


The PC version of the TMS32020/C25 simulator has the restriction that 
only 14 files of any kind may be open at any one time. While the users 
can assign a file to any one of 16 input and output ports, they are re- 


stricted to a maximum of 14 total files. Having files open for other pur- 
poses (e.g., journal file collection) further restricts the number of total files 
that are available for port assignment. Increasing the FILES = _ in the 
CONFIG.SYS file over 20 will not allow the simulator to use more than 
20 files simultaneously. 
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2.3 Command Line Entries (TMS32020/C25) 


Once the appropriate system assignments have been made during the instal- 
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lation instructions, several entries can now be made when the simulator is 


invoked. The format of command line entries is as follows: (The "|" symbol 
stands for “OR”"). 


SIM25 {-2..d0-d7:b0-b/) [=c] [-3 <filename>] [-m 1/0] 


[-t <nrows> ] 


Each of these commands is discussed separately below. 


1) 


2) 


The -a dOQ-d7:b0-b7 command is for PC USE ONLY. This command 
sets attributes for screen color. The following table and example explains 
the entry sequence. 


Colors Display Attributes Bold Attributes 
do bO 


black 

blue d1 b1 
green d2 b2 
cyan d3 | b3 
red d4 b4 
magenta db b5 
yellow d6 b6 
white d7 b7 


Example: When invoking the simulator enter: 


<a =§ «OT 8 ilROREED 8 aia 


When the opening simulator screen appears, the display will be red with 
bold white headings. 


The -c command turns off the clock simulation run. This command im- 
proves the speed of the simulation for runs where clock speed is not re- 
levant. 


Example: When invoking the simulator enter: 
SIM25 -c <CR> 


Note: 


Although the clock counter (CLK) still appears on the display and appears 


to be working, the clock is no longer accurate and the speed of the simu- 


lator is improved. 
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3) 


4) 


5) 


The -j <filename> command loads and runs a given journal file. 
Example: When invoking the simulator enter: 


This command starts the simulator and immediately executes the journal 
file TEST.JNL. 


The -m O|1 command sets the memory configuration. If a 0 is entered, 
the first 4K words are configured as internal ROM. An entry of 1 will 
configure the first 4K words as external ROM. 


Example: When invoking the simulator enter: 
SIM25 -m 1 <CR> 


Instead of the next screen prompting the user to configure the memory, 
this command starts the simulator and configures the first 4K words 
memory as external. 


The -t <nrows> command sets the length of the trace buffer sample 
to be taken if Trace mode ts to be used. 


Example: When invoking the simulator enter: 
SIM25 -t 10 <CR> 


This command starts the simulator and sets the trace buffer to accept 
only 10 rows of data. 
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2.4 TMS320C10 Execution Verification 


TMS320C10 Simulator execution can be verified by one of two methods. The 
first part of this verification procedure, described below, is the same for both 
methods. 
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1) 


2) 


3) 


4) 


Log onto the simulator from the host operating system: 


On VAX/VMS systems (version 3.7), activate the TMS320C10 Simu- 
lator by entering the following command after the system prompt: 


RUN [<userid.dir>]SIM.EXE <CR> 


On MS/PC-DOS systems (versions 2.0 and up), create a path with the 
correct PC path command, then enter: | 


SIM <CR> 


Immediately after logon, all RAM and ROM locations are initialized to O 
(the TMS320C10 ADD instruction). 


Next, the simulator prompts for the processing mode that is to be simu- 
lated: microcomputer or microprocessor mode. 


Microprocessor mode, with program memory addresses >0 to >1535 
off-chip, is the default mode. It may be selected by entering a zero or a 
Carriage return after the system prompt, ENTER COMMAND 
(HELP=<CR>). You will see the following display: 


AC) Copyright Texas Instruments 
_ Incorporated 1984 


SIMULATION OF THE TMS320C10 
: VERSION # X.X 


QO - MICROPROCESSOR MODE (ADDR 0-1535, OFF CHIP) 
1 - MICROCOMPUTER MODE (ADDR 0-1535, ON CHIP) 


ENTER VALUE TO SELECT MODE OF OPERATION 
Q <CR> | 


YOU ARE IN THE MICROPROCESSOR MODE (ADDR O-1535, 
OFF CHIP) © 


ENTER COMMAND (HELP=<CR>) : 


After choosing the processing mode, proceed with verification Method 


1 (Section 2.4.1) or Method 2 (Section 2.4.2). 


installation/Execution - TMS320C10 Execution Verification 


2.4.1 Method 1: Entering Commands 


The following example loads the TMS320C10 IN. and OUT instructions into 
program ROM via the ROM (modify/inspect program ROM) command. The 
simulator reads a single number and outputs that same number. Note that the 
BIAQ (breakpoint on instruction acquisition) command ts used to stop exe- 
cution. Without the BIAQ command, the simulator would continue to execute 
all ADD instructions until the end of the ROM locations was reached. 


ENTER COMMAND (HELP=<CR>): 


ROM <CR> 

ENTER STARTING ADDRESS (IN HEX) 

Q <CR> 
O = 0 

4210 <CR> *Opcode for the TMS320C10 IN instruction.* 
O = 4210 

+ <CR> — *Move to the next ROM address.* 
1 = @) 

ADO: -<CR> *Opcode for the TMS320C10 OUT instruction.* 
1 = 4D10 

Q <CR> *End the ROM modification.* 


ENTER COMMAND (HELP=<CR>): 
BIAQ <CR> *Set the end of the simulation.” 


BREAK ON INSTRUCTION ACQUISITION 
ENTER THE ADDRESS (IN HEX) 
3 <CR> 


ENTER COMMAND (HELP=<CR>) : 
R <CR> *Run the simulation.” 


The first clock shows that the IN instruction, opcode=4210, is loaded into the 
simulator. The value >56 was chosen arbitrarily; RAM location >10 is en- 
coded in the IN opcode. 


>>PC= QO OPCODE=4210 IN PREVIOUS PC= 0 
ARP ARO ARI TREG PREG ACC CLK 
INTEGER 0 0 0 0 0 0 1 
HEX 0 0 0 0 0 0 1 
>>STK= 0 6) 0 0 DP = 0 INTF= 0 OV = 0 
BIO= 1 INTM= 0 OVM= 0 
ENTER INPUT VALUE (IN HEX) OR "-" TO RETURN TO MAIN 
56 <CR> *Load value into RAM location >10.* 


* * * OUTPUT VALUE (IN HEX) IS 56 


2-9 


Install 


ation/Execution - TMS320C10 Execution Verification 


Execution breaks when the simulator attempts to fetch an instruction at lo- 


cation >3. 
>>PC= 3. OPCODE= 0 ADD PREVIOUS PC= 2 
ARP ARO AR1L  TREG PREG ACC CLK 
INTEGER 0 O 0 0 0 0 6 
HEX 0 0 0 0) 0 0) 6 
>>STK= 0 0 0 0 DP = 0 INTF=0 OV =0 
BIO= 1 INTM= 0 OVM= O 


>>> INSTRUCTION ACQUISITION BREAK POINT # 1 <<< 


ENTER COMMAND (HELP=<CR>) : 


RAM <CR> *Verify that RAM location >10 contains >56.* 
ENTER STARTING ADDRESS (IN HEX) 
10 <CR> 
LO: = 56 
Q <CR> *Quit the simulation.” 


ENTER COMMAND (HELP=<CR>): 


2.4.2 Method 2: Loading a File 


The second method loads an absolute file into the simulator to verify simulator 
execution. 


1) 


2) 


Create, edit, assemble, and link (if necessary) a TMS320C10 source 
code file on the host system. For more information on writing, assem- 
bling, and linking the code, refer to the T7WM@S320C70 Assembly Lan- 
guage Programmer's Guide (literature number SPRUOQO2). 


The following example accesses a program called INOUT.MPO, which 
contains the TMS320C10 IN and OUT instructions. 


The source file for INOUT.ASM is: 


AORG @) 

IN >0010,2 Read a word from a peripheral on port 
address 2 into ROM location >0010 
(opcode=4210). 

OUT 2001075 Write a word from ROM location >0010 


to a peripheral on port 5 
(opcode = 4D10). 


After INOUT.ASM has been assembled, linked (if necessary), and 
tagged on the host system, it is loaded into the simulator via the L (load) © 
command. Note that when any file is loaded into the simulator, it is 
important that the file be an absolute, ASCII tagged object file. The 
following display shows the series of prompts produced by the L (load) 
command. : 


ENTER COMMAND (HELP=<CR>): 
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3) 


L <CR> 


ENTER A NEW OBJECT FILE 
INOUT.MPO <CR> 


* * * * LOADING PROGRAM "NOSIDT" x * * 
ENTER COMMAND (HELP=<CR>): 


Once the absolute object file is loaded, set a breakpoint with the BIAQ 
(breakpoint on instruction acquisition) command and use the R (run) 
command to run the simulation. The displays are shown below. 


ENTER COMMAND (HELP=<CR>): 
BIAQ <CR> *Set the end of the simulation.” 


BREAK ON INSTRUCTION ACQUISITION 
ENTER THE ADDRESS (IN HEX) 
3 <CR> 


ENTER COMMAND (HELP=<CR>): 
R <CR> *Run the simulation.“ 


The first clock shows that the IN instruction, opcode=4210, is loaded 
into the simulator. The value >56 was chosen arbitrarily; RAM location 
>10 is encoded in the IN opcode. 


>>PC= O OPCODE=4210 IN PREVIOUS PC= O 
ARP ARO AR1 TREG PREG ACC CLK 
INTEGER 0 0 O 0 0 0 1 
HEX 6) 0 0 O 0 0 1 
>>STK= 0 6) 0 0 DP = 0 INTF= 0 OV = 0 
BIO= 1 INTM= 0 OVM= 0 
ENTER INPUT VALUE (IN HEX) OR "-" TO RETURN TO MAIN 
56 <CR> *Load value into RAM location >10.* 


* * * OUTPUT VALUE (IN HEX) IS 56 


Execution breaks when the simulator attempts to fetch an instruction at 
location >3. | 


>>PC= 3 OPCODE= 0 ADD PREVIOUS PC= 2 

ARP ARO ARI TREG PREG ACC CLK 
INTEGER 0 0 0 0 0 O 6 
HEX @) 0 O 0 @) 0 6 


>>STK= 0 ) 0 0 DP = 0 INTF= 0 OV = 0 
BIO= 1 INTM= O OVM= 


>>> INSTRUCTION ACQUISITION BREAK POINT # 1 <<< 


ENTER COMMAND (HELP=<CR>): 
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Use the RAM (modify/inspect individual data RAM) command to verify 
that the desired value has been placed in the specified memory location. 
The display produced by the RAM command is: 


ENTER COMMAND (HELP=<CR>): 


RAM <CR> *Verify that RAM location >10 contains >56.* 
ENTER STARTING ADDRESS (IN HEX) 
10 <CR> 
10 = 56 
Q <CR> *Quit the simulation.” 
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2.5 TMS32020/C25 Execution Verification 


TMS32020/C25 simulator execution can be verified by one of two methods. 
The first part of this verification procedure, described below, is the same for 
both methods. 


1) 


2) 


3) 


Log onto the simulator from the host operating system: 


On VAX/VMS systems (version 3.7), activate the TMS320C25 Simu- 
lator by typing the following command after the system prompt: 


RUN [<userid.dir>]SIMC25 <CR> 


On MS/PC-DOS systems (versions 2.0 and up), memory requirements 
should be considered. The simulator will operate on a PC with only 
512K words of memory, however, we strongly urge users to use systems 
with 640K words of memory. To execute the simulator enter: 


SIM25 <CR> 

The simulator will ask whether an IBM PC or TIPC is in use. Enter: 
0 if using an IBM PC or a “close compatible” of an IBM PC. 
i if using a Texas Instruments Professional Computer. 


Note that proper functioning of this software has been verified only on 
the IBM PC/XT, IBM PC/AT, and Texas Instruments Professional com- 
puters. 


Next, the simulator prompts for the memory configuration, selecting first 
4K words as internal or external program ROM. 


Selecting internal program ROM is the default, and can be done by en- 
tering a zero or a Carriage return after the system prompt, COMMAND. 
The display ts: 


(C) COPYRIGHT TEXAS INSTRUMENTS 
INCORPORATED 1986 
TMS320C2x SIMULATOR 
RELEASE x.X XX.XXX 


O : First 4K words INTERNAL program ROM 
1 : First 4K words EXTERNAL program ROM 


Enter the memory configuration (0 or 1): 
<CR> 


First 4k WORDS are mapped on Internal ROM 


COMMAND: 


After choosing the memory map configuration, the following initial 
conditions result: 


@ All program ROM locations are initialized to 0 (the TMS320C25 
ADD instruction). 
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The program counter (PC) should be set to >0. To ensure that 


program execution begins at the first location in the program, each 
L (load) command should be followed by the RS (reset) com- 
mand. This places >0 in the PC; location >0 is the reset vector and 
should branch to the starting program location. Program ROM 
(>0 to >1F) is for interrupts and reserved for other system uses. 
All executable code should start to load from >20. 


The Data Memory Page Pointer (DP) is set to 4. 


a) If on-chip memory block BO is data RAM, the DP points to 
data RAM address 512. 


b) If on-chip memory block BO is program ROM, note that data 
memory addresses 512 to 767 (DP4 and DP5) do not exist. 


The BIO (I/O branch control) pin is initialized to 1 (branch control 


increments to next instruction). 


All other registers and flags are initialized per the 7WS320C2x 
Second-Generation User's Guide. 


If an ST command (display/update register status) is performed after 
logging on to the simulator, the following display appears: 


COMMAND: ST <CR> 


:0000 ADD 
:O0000 ADD 
:0000 ADD 
:O0000 ADD 
ARO: 0000 
ARI: 0000 
AR2: 0000 
AR3: 0000 
AR4: 0000 
ARS: 0000 
ARO: 0000 
0000 


_ AR7: 


4) Now, proceed with execution verification Method 1 (Section 2.5.1) or 
Method 2 (Section 2.5.2). | 


>0200 C25 M-—_—— 
>0200 IFR :000000 STO:0604 ST1 :O7FO BIO 1 
>0200 IMR :O000000 | ARB:0O ARP :0 CNFD 
>0200 MMRS CRY:0 DP :04 FO :0O 
STACK DRR :0000 FSM:1 INTM: 1 OV :0 
SkO: QOOO | DXR : 0000 OVM: 1 PM :1 SXM:1 
SK1: OOOO | TIM :FFFF TC :0 TXM :0O XF :1 
SK2: OOOO | PRD :FFFF OUTP : 0000 
SK3: OO00 | GREG: 0000 RPTC: 0 CLK: @ 
SK4: 0000 
SK5: 0000 TREG: 0000 
SK6: OO000 } PREG: OO000000 
SK7: 0000 ACC : 00000000 
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2.5.1 Method 1: Entering Commands 


od 
ae 
“2 
3 


In the following example, the TMS320C25 IN and OUT instructions are 
loaded into program ROM via the ROM (modify/inspect program ROM) 
command. The simulator reads a single number and outputs that same num- 
ber. Note that the BIAQ (breakpoint on instruction acquisition) command is 
used to stop execution. Without the BIAQ command, the simulator would 
continue to execute all ADD instructions until the end of the ROM locations 
was reached. 


20 = 0 8210 <CR> *Opcode for the TMS320C25 IN instruction.* 
20 = 8210 + <CR> *Move to the next ROM address.” 

21 = O E510 <CR> *Opcode for the TMS320C25 OUT instruction.” 
21 = E510 Q <CR> *Quit the ROM modification.” 


COMMAND: BIAQ <CR> “*Set the end of the simulation.” 


Break on Instruction Acquisition 
Enter the address (in Hex): 23 <CR> 


COMMAND: PC <CR> 


Present value for program counter: 0 
Enter a new value for the PC (in Hex) : 20 <CR> 


COMMAND: R <CR> *Run the simulation.” 


The first clock shows that the next instruction to be executed by the simulator 
(PC) is 20. The value >56 was chosen arbitrarily; RAM location >210 is en- 
coded in the IN opcode. 


:0020 ALD >0200 CB A0—_—__——_—_——-————— 

:0000 ADD >0200 IFR :000000 STO:0604 ST1 :O7FO BIO 1 

:0000 ADD >0200 IMR : 000000 ARB:0 ARP :0O CNFD 

:0000 ADD >0200 MMRS CRY2 i DP :04 FO :0 
STACK DRR : 0000 FSM:1 INTM: 1 OV :0 

ARO: 0000 SKO: OOOO | DXR : 0000 OVM: 1 PM :1 SXM: 1 

ARI: 0000 SKi: OOOO | TIM :FFFF TC: 20 TXM :0 Ae ack 

AR2: 0000 SK2: OOOO | PRD :FFFF OUTP: 0000 

AR3: 0000 SK3: OOOO | GREG: OOOO RPTC: 0 CLK: O 

AR4: 0000 SK4: OOOO 

AR5: 0000 SK5: OQO0O00 TREG: 0000 

ARG: 0000 SK6o: OO000 PREG: OOO000000 

AR7: OO0O0 SK7: QO0O0O ACC : O0000000 


56 <CR> 


The value >56 has been loaded into RAM location 210. Execution breaks 
when the simulator attempts to fetch an instruction at location >23. The 
screen now looks like the following. 
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PC 


mo ak 
~2 


=3 


20024 ADD >0200 : ——_— 
20023 ADD >0200 IFR :O000000 STO:0604 ST1 :0O5FO BIO 1 
20022 ADD >0200 IMR : 000000 ARB:O ARP :0 CNFD 
:0021 ADD >0200,>5 MMRS ——| CRY: 0 DP :04 FO :0 

: STACK DRR : 0000 FSM:1 INTM: 1 OV :0 
ARO: 0000 SKO: OOOO |DXR :0O000 OVM:1 PM si SXM:1 
ARI1L:. 0000 SK1: 0000 |TIM :FFF9 TC..-2i0 TXM :0 XF :1 
AR2: 0000 SK2: OOOO |PRD :FFFF OUTP:0056 
AR3: 0000 SK3: 0000 |GREG: 0000 RPTC: O CLK: 6 
AR4: 0000 SK4: 0000 
AR5: 0000 SK5: 0000 TREG: 0000 
ARG: 0000 SK6: 0000 PREG: 00000000 
AR7: 0000 SK7: 0000 ACC : O0O000000 

>> instruction acquisition breakpoint # 1 << 


COMMAND: RAM <CR> 


—C25 MP 


*Verify that RAM location >210 contains >56.* 


Enter start DATA address (in Hex) 210 <CR> 


210: = 


56 Q <CR> 


2.5.2 Method 2: Loading a File 


The second method loads an absolute file into the simulator. 


1) 


*Quit the simulation.” 


Create (or edit), assemble, and link (if necessary) a TMS320C25 source 

code file on the host system. For more information on writing, assem- 
bling, and linking the code, refer to the 7MS32020 User's Guide angie! 
the TMS320C25 User's Guide. 


The following example accesses a program called INOUT.MPO, which 
contains the TMS32020/C25 IN and OUT instructions. 


The source file for INOUT.ASM is shown below. 


AORG 


IN 


OUT 


>20 


>0010,2 


>0010,5 


Read a word from a peripheral on port 
address 2 into ROM location >0010 
(opcode=8210). 


Write a word from ROM location >0010 
to a peripheral on port 5 
(opcode = E510). 
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PC 
eae! 
me 
=3 


2) 


3) 


:0020 
:0000 
:0000 
:0000 


ARO: 
ARI: 
AR2: 
AR3: 
AR4: 
ARS: 
AR6: 
AR7: 


Assemble INOUT.ASM on the host system and load it into the simulator 
via the L (load) command. Note that when any file is loaded into the 
simulator, it is important that the file be an absolute, ASCI/ tagged object 
file or a COFF file. The following display shows the series of prompts 
produced by the L (load) command. 
COMMAND: L <CR> 
Enter a new object file : INOUT.MPO <CR> 
**k**X TOADING PROGRAM "NOSIDT Do SRR 
COMMAND: 
Once the absolute object file is loaded, set a breakpoint with the BIAQ 
(breakpoint on instruction acquisition) command and use the R (run) 
command to run the simulation. The displays are: 
COMMAND: BIAQO <CR>*Set the end of the simulation.” 
Break on Instruction Acquisition 
Enter the address (in Hex) : 23 <CR> 
COMMAND: PC <CR> 
Present value for program counter: e) 
Enter a new value for the PC (in Hex) : 20 <CR> 
COMMAND: R <CR> *Run the simulation.” 
The first clock shows that the next instruction to be executed by the si- 
mulator (PC) is 20. The value >56 was chosen arbitrarily; RAM location 
>210 is encoded in the IN opcode. 
ADD >0200 C25 MP 
ADD >0200 IFR :OO00000 STO:0604 ST1 :O7FO BIO 1 
ADD >0200 IMR : 000000 ARB:0 ARP :0 CNFD 
ADD >0200 MMRS CRY:1 DP :04 FO :0 
STACK DRR :0000 FSM:1 INTM: 1 OV :0 
0000 SKO: OOOO |DXR :O000 OVM: 1 PM :1 SXM: 1 
0000 SK1l: OOOO | TIM :FFFF Te 230 TXM :0 XF :1 
0000 SK2: OOOO |PRD :FFFF OUTP : 0000 
OOOO SK3: OOOO | GREG: 0000 RPTC: 0 CLK: 0O 
OOOO SK4: QO0O00 
0000 SK5: OOOO TREG: 0000 
0000 SK6: 0000 PREG: OO0OO00000 
0000 SK7: OOOO ACC OOO00000 
56 <CR> 
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2-18 


:0024 


:0023 
:0022 
:0021 


| ARO: 


AR1: 
AR2: 
AR3: 
AR4: 
AR5: 
AR6: 
AR7: 


4) 


The value >56 has been loaded into RAM location >210. Execution 
breaks when the simulator attempts to fetch an instruction at location 


> 23. 


ADD >0200 
ADD >0200 
ADD >0200 
ADD >0200 


0000 
0000 
0000 
0000 
0000 
0000 
0000 
0000 


,79 
STACK 

SKO: 0000 
SK1: 0000 
SK2: 0000 
SK3: 0000 
SK4: 0000 
SK5: 0000 
SK6: 0000 
SK7: 0000 


— C25 MP—————__________— | 
IFR :000000 STO:0604 ST1 :O5FO BIO 1 
IMR :OQO0000 ARB:0 ARP :0 CNFD 

MMRS CRY: 1 DP :04 FO :0 

DRR : 0000 FSM:1 INTM: 1 OV :0 
DXR :0000 OVM:1 PM :1 SXM:1 
TIM :FFF9 TC :0 TXM :0 XF :1 
PRD :FFFF _| OUTP:0056 
GREG: 0000 RPTC: 0 CLK: 6 

TREG: 0000 


PREG: 00000000 
ACC : 00000000 


>> instruction acquisition breakpoint # 


L << 


Now use the RAM (modify/inspect individual data RAM) command to 
verify that the desired value has been placed in the specified memory 
location. The display produced by the RAM command is: 


COMMAND: RAM <CR> “*Verify that RAM location >210 contains >56.* 


Enter start DATA address (in Hex) 210 <CR> 


210 = 56 Q <CR> 


*Quit the simulation.” 


Section 3 


Simulator Commands 


The TMS320 Simulator commands perform specific simulator functions. This 
section describes special control operations unique to the VAX/VMS and 
MS/PC-DOS operating systems. A command set summary that lists com- 
mands according to function is provided for easy reference. These commands 
are also described individually. 


Each command page contains a description of the command, an example dis- 
play with appropriate responses, and an explanation of the display. Note that 
although the format of the display varies depending on the simulator you are 
using, the information remains the same. 


Topics in this section include: 


Section Page 
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Note: 
Commands must be entered in UPPERCASE LETTERS. !f a command ts 


entered in lowercase letters, the simulator will issue an *** INVALID 
COMMAND* ** error message. 


Before attempting to execute the simulator, verify that the simulator has been 
correctly installed by performing either execution verification Method 1 or 
Method 2 (see Section 2). 
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Simulator Commands - Control Operations 


3.1 Control Operations 
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Special control operations are provided to halt command execution in mid- 


Operation and return to the simulator prompt. 


VAX/VMS 


® <CNTRL- C> halts any run mode process ang returns the user to the 
simulator prompt. 


@ <ESC> halts any command mode process and returns the user to the 
simulator prompt. 


MS/PC-DOS 


8 <ESC> halts any process (run or command mode) and returns the user 
to the simulator prompt. 


On the TMS320C10 VAX/VMS operating systems, entering a carriage return 
while executing any command except EX, JF, or L leaves the present value 
unchanged. If a carriage return is entered while using the JF (journal file) 
command, a new file called FORO88.DAT is created and stored in the current 
user directory. On the TMS320C10 MS/PC-DOS and TMS32020/C25 
VAX/VMS and MS/PC-DOS an error message will be displayed when a car- 
riage return is entered while using the JF command. Entering a carriage return 
within the EX (execute) or L (load) commands produces an error message for 
all simulators. File names are subject to host system constraints. For example, 
file names may contain up to nine alphanumeric characters (uppercase A-Z 
and 0-9). 


On MS/PC-DOS operating systems, entering a carriage return while execut- 
ing any command leaves the present value unchanged. File names are subject 
to host system constraints; for example, file names must be up to eight char- 
acters long and contain no blanks. 
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3.2 Command Set and Menu Summary 


The TMS320 simulator command set summary in Table 3-1 is arranged ac- 
cording to function, alphabetized within each functional grouping. If a com- 
mand is not supported by all TMS320 simulators, the simulators that do 
support the command are noted in parentheses. 


Example: EH Execution Help Menu (TMS320C25) 


The EH command is supported only by the TMS320C25 according to this 
example. : 


The contents of eleven display menus provide the groupings. Four of the help 
menus, DH, EH, TH, and UTLH, are unique to the TMS320C25. The eleven 
display menus are: | 


® Display Main Menu (DM) 

@ Breakpoint Help Menu (BH) 

® Display Help Menu (DH), TMS320C25 only 

@ Execution Help Menu (EH), TMS320C25 only 

@ Modify/Inspect Memory Help Menu (MH) 

@®  $Modify/Inspect Registers/Flags Help Menu (RH) 
®@ Input/Output Help Menu (!OH) 

@ 


Modify/Inspect Status Registers/Pins Help Menu (STH), TMS32020 
and TMS320C25 


@ Trace Help Menu (TH), TMS320C25 only | 
® Interrupt/Timing Help Menu (TICH), TMS32020 and TMS320C25 
@ 


Utilities Help Menu (UTLH), TMS320C25 only 
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Table 3-1. Simulator Command Set Summary | 


MAIN MENU COMMANDS 

| Command | _ Functiont 

. | Display Variable Value and Format (TMS320C25) 

Del 

DM or <CRS 

Ul. 
IF 
SIM | Change Simulator Mode (TMS92020, TMS320025) 
ST |_Display/Update Register Status 


T Save Trace Buffer 
Switch from Screen to File (TMS32020/C25) 
| Toggle Trace 


Oo 
O 


~” 
8) 


atl 
B 


IN| alo 


Zero Clock Cou nter 


__ZRAM Set RAM Contents to Zero (TMS32020/C25) | 


HELP COMMANDS | 
Functiont 


Breakpoint Help | 
Display Controller Help Menu (TMS320C25) 
Execution Help Menu (TMS320C25) 

| input/Output Help Menu - | 

7 Modify/Inspect Memory Help Menu _ 


Modify/Inspect Status Registers/Pins Help Menu | - 
(TMS32020/C25) | 


| Trace Help Menu (TMS320C25) | 
{ _Interrupt/Timing Help Menu (TMS32020/C25) 
_Utilities Help Menu {TMS32020/C25) 


Pes pee EXECUTION COMMANDS | | 
Command 
a Rianne TTT 
ERAM | Expand RAM and ROM (TMSs20G10) SSS 
x 
[tc [toad New COFF File —SOSC—~—~SC‘C~‘<;<S;~‘~* 


| Set Number of Instructions Until Break (TMS320C10, 
TMS320C25) __ 
Ee rae Sine OCG SIO a et 


Run Simulation 


_RS- Reset Simulator _ 
Ss Perform Single-Step Execution 


tT If a command pertains to one or two processors only, this is indicated in parentheses. 
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Table 3-1. Simulator Command Set Summary (Continued) 


BREAKPOINT COMMANDS 


INPUT/OUTPUT COMMANDS 
LF 


| LF | List Files Assigned to Ports (TMS320C10) 
List Files Assigned to Input Ports (TMS32020/C25) 


[si] Select input Port File 


Assign XMT Channel to File (TMS320C25) 
Close the XMT Channel File (TMS320C25) 


INTERRUPT/TIMING COMMANDS 


DWAIT Specify Wait Cycles for External Data Memory (TMS32020, 
TMS320C25) aa | 
IOWAIT | Specify Wait Cycles for External 1/0 Memory (TMS32020, 
TMS320C25) | 
PWAIT Specify Wait Cycles for External Program Memory (TMS32020, 
TMS320C25) | 


Specify Number of Clock Tics until Next Interrupt (TMS320C10) 


TICO-TIC2 Specify Number of Clock Tics (TICO-TIC2) until Interrupt 
(TMS32020, TMS320C25) | 
ZTIC Disable Tic Commands | 


tT {f a command pertains to one or two processors only, this is indicated in parentheses. 
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Table 3-1. Simulator Command Set Summary (Continued) 


[command [Function 
[acc | Modify/inspect Accumulator SSS 
[ak | Modity/inspect Auxillary Registows 
[B10 | Modity/inspect 1/0 Branch Control 
[cc | Madity/inepect Clock Counter 
[Fs | Modity/inspect Frame Syne Mode (TMS320025) 
[P| Modityinspect P Register 


RPTC 


Modify/ Inspect Program Counter - 
| SK Modify/Inspect Stack 


ACC 
AR 
CC 
FSM 
PC 
. Modify/Inspect Repeat Instruction Counter (TMS32020, 
TMS320C25) 
SK 


t If a command pertains to one or two processors only, this is indicated in parentheses. 
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Table 3-1. Simulator Command Set Summary (Concluded) 


MODIFY/INSPECT STATUS REGISTERS/PINS COMMANDS 
Command Functiont | 


ARB Modify Auxiliary Register Pointer Buffer (TMS32020, 
TMS320C25) , 


Modify/Inspect Auxiliary Register Pointer 


Modify/Inspect RAM Configuration Control Bit (TMS32020, 
TMS320C25) 


ARP 
CNF } 
CY Modify/Inspect Carry Bit (TMS320C25) 

Modify/Inspect Data Memory Page Pointer 
FO Modify/Inspect Format Bit (TMS32020, TMS320C25) 
HM Modify/Inspect Hold Mode Bit (TMS320C25) 
OV 
OVM 


INTM 
Modify/Inspect Overflow Mode Register 
RINTM Modify/Inspect RINTM Bit (TMS320C25) : 


SXM Modify/Inspect Sign-Extension Mode Bit (TMS32020, 
TMS320C25) = 


TC Modify/Inspect Test/Control Flag Bit (TMS32020, TMS320C25) 
TXM Modify/Inspect Transmit Mode Bit (TMS32020, TMS320C25) 
XF Modify/Inspect XF Pin (TMS32020, TMS320C25) 


XINTM Modify/Inspect XINTM Bit (TMS320C25) 
t If a command pertains to one or two processors only, this is indicated in parentheses. 
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3.3 Individual Command Descriptions 
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This section describes each simulator command, presented in alphabetical or- 
der. If a command is not supported by all TMS320 simulators, the simulators 
that do support the command are noted in parentheses. 


Example: RCVC Close RCV Channel File (TMS320C25) 


The RCVC command is supported only by the TMS320C25 according to this 
example. 


A description, example display, and explanation of the display are given for 
each command. User responses are underlined. Differences in particular 
command functions for the TMS320C10, TMS32020, or TMS320C25 are ‘in- 
dicated in separate examples. Depending on the simulator you are using, your 
screen displays may vary from the example displays. The information, though, 
remains the same. 


Modify/Inspect Accumulator ACC 


Description 


Example 7 


ACC allows you to inspect and change the accumulator value. After the 
present accumulator value is displayed, a new value can be entered. En- 
tering a carriage return leaves the value unchanged. ACC is listed in me 
RH menu. 


ENTER COMMAND (HELP= “<CR>) 
ACC <CR> 


PRESENT ACCUMULATOR VALUE 
> 0 

ENTER NEW VALUE (IN HEX) 
10 <CR> | 


ENTER COMMAND (HELP=<CR>) : 


To verify the modification, repeat the ACC command or enter the ST com- 
mand to display/update the value in the accumulator. 
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AR Modify/Inspect Auxiliary Registers 
Description AR allows you to inspect and change auxiliary register values. After 
prompting for the auxiliary register number, the register is displayed for | in- 
spection and/or modification. AR is in the RH menu. 
Example This display appears for the TMS320C1 0. 
| ENTER COMMAND (HELP= <CR>) : 
AR <CR> 
ENTER THE AUXILIARY REGISTER NUMBER (O - 1) OR ENTER "-" 
TO TERMINATE 
1 <CR> 
ARI = >0 
ENTER NEW VALUE (IN HEX) 
7 <CR> 
ENTER THE AUXILIARY REGISTER NUMBER (O - 1) OR ENTER "-" 
TO TERMINATE 
- <CR> . 
ENTER COMMAND (HELP=<CR>): 
Example This display appears for the TMS32020/C25. 


COMMAND: AR <CR> 


Enter the aux-reg number (0-7) or enter "-" to terminate 1 <CR> 
AR ie e) 

Enter new value (in Hex) : 7 <CR> 

Enter the aux-reg number (0-7) or enter "-" to terminate : - <CR> 


COMMAND : 
To verify the modification, repeat the AR command or enter the ST com- 


mand to update the values in the AR registers. 


Note: 
Although the screen for the TMS32020 simulator shows values for 8 


auxiliary registers, remember the TMS32020 simulator has only 5 auxiliary 
registers. Therefore, although the prompt asks for a value between QO and 
7, only a number between O and 4 will have an effect on the simulator. 


Modify/Inspect Auxiliary Register 
Pointer Buffer (TMS32020/C25) ARB 


Description 


Example 1 


ARB displays and allows modification of the auxiliary register pointer buf- 


fer. ARB its listed in the TMS32020 and TMS320C25 Simulator STH menu. 


This display appears for the simulator. 
COMMAND: ARB <CR> 


Present value of AR-Reg pointer buffer : O 
Enter new value (0 - 7) ; 2 <CR> 
COMMAND: 


Note that when the ARB value is changed, the Auxiliary Register Pointer 
(ARP) is also changed to the new value. 


To verify the modification, repeat the ARP command or enter the ST com- 
mand. The arrow (==>) now points at the updated auxiliary register value. 


ARP | Modify/Inspect Auxiliary Register Pointer 


Description ARP allows you to inspect and change the auxiliary register pointer value. 
= The ARP command is in the STH menu of all of the simulators. 


The TMS320C10 has two auxiliary registers, ARO and AR1, so ARP can be 
set to 0 or 1 for the TMS320C10. The TMS32020 has five auxiliary regis- 
ters, ARQ-AR4, so ARP can be set to 0-4 for the TMS32020. The 
TMS320C25 has eight auxiliary registers, ARO-AR7, so ARP can be set to 
0-7 for the TMS320C25. 


Table 3-2. Auxiliary Register Pointer Values 


ARP Result 


[AR4 auxiliary register 4 


AR5 — auxiliary register 5 
| AR6 ~ auxiliary register 6 


AR7 — auxiliary register 7 


Example This display appears for the TMS320C10. 


ENTER COMMAND (HELP=<CR>): 
ARP <CR> 


PRESENT VALUE OF THE AUXILIARY REGISTER POINTER 
1 ‘ 


ENTER NEW VALUE (0,1) 
OQ <CR> 


ENTER COMMAND (HELP=<CR>) : 


Modify/Inspect Auxiliary Register Pointer ARP 


Example 


This display appears for the TMS32020/C25 


Command ARP <CR> 


Present value of the AR-Reg pointer buffer : 1 
Enter new value (0-7): O <CR> 


Command 


To verify the modification, note the arrow movement to the left of the aux- 
iliary register display. 


Note: 
Although the screen for the TMS32020 simulator shows values for 8 


auxiliary registers(O-7), the TMS32020 simulator has only 5 auxiliary re- 
gisters. Therefore, only a value entered in the first 5 registers (0-4) will 


have an effect on the simulator. 


oe e | Breakpoint on Data Pattern 
BDP When Read/Write from/to Data RAM 


Description BDP suspends simulator execution when a specified bit pattern is read from 
or written to data RAM. The system prompts for a pattern of ones, zeros, 
and Xs. The Xs correspond to the don’t care state. Be sure to use Xs, not 
blanks; when a blank is entered for a bit position, the following bits are also 
treated as blanks, thus producing a bad bit pattern. 


Use the C command to resume simulation. BDP is listed in the BH menu. 


Example 7 ENTER COMMAND (HELP=<CR>) : 
BDP <CR> 


BREAK ON DATA RAM R/W 

ENTER BIT PATTERN OF 16 BITS (0,1,X) 
FIRST BIT IS MSB 

111100001111 XXxXX <CR> 


THE 16 BITS ENTERED ARE: 
15, 24. 23 tobe LO 9S 6B 7 B.-A SB ae OE 


aE de. Cs Sie 1G SOE sO OO a a oF sae Oe oe 
ENTER COMMAND (HELP=<CR>): 

When the value >FOFX is read from or written to data RAM, the simulator 
stops execution. 


Use the DB command to display the breakpoint and its reference number. 
To remove the breakpoint, use the RB command. 


Breakpoint on Data RAM Read BDR 


Description 


Example 


BDR suspends simulator execution when a data memory address within a 
user-specified address range is read. The system prompts for the beginning 
and ending hexadecimal addresses. The maximum value for any range is 
>8F for the TMS320C10 Simulator and >FFFF for the TMS32020 and 
TMS320C25 Simulators. 


Use the C command to resume simulation. BDR is listed in the BH menu. 


ENTER COMMAND (HELP=<CR>): 
BDR <CR> 


BREAK ON DATA RAM READ 
ENTER THE BEGINNING ADDRESS (IN HEX) 
5 <CR> 

ENTER THE ENDING ADDRESS (IN HEX) 

F <CR> 


ENTER COMMAND (HELP=<CR>) : 
When a data RAM address within the inclusive range >5 - >F is read, the 
simulator stops execution after processing the read. 


Use the DB command to display the breakpoint and its reference number. 
To remove the breakpoint, use the RB command. 


— BDRW- 


Description 


Example 
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Breakpoint on Data RAM Read and Write 


- BDRW suspends simulator execution when an address within a user-spe-. 


cified address range is read from or written to. The system prompts for the 
beginning and ending hexadecimal addresses. The maximum value for any 
range is >8F on the TMS320C10 Simulator and > FFFF on the TMS32020 


and TMS320C25 Simulators. 


~ Use the C command to resume simulation. BDRW is listed in the BH menu. 


ENTER COMMAND (HELP=<CR>) : 


BDRW <CR> 


BREAK ON DATA RAM READ AND WRITE 
ENTER THE BEGINNING ADDRESS (IN HEX) 


5 <CR> 


ENTER THE ENDING ADDRESS (IN HEX) 


F <CR> 


ENTER COMMAND (HELP=<CR>): 


When a data RAM address within the inclusive range >5 — >F is read from 
or written to, the simulator stops execution after processing the read or 
write. 


Use the DB command to display the breakpoint and its reference number. 
To remove the breakpoint, use the RB command. 


Breakpoint on Data RAM Write BDW 


Description 


Example 


BDW suspends simulator execution when a data RAM address within a 
specified range is written to. The system prompts for the beginning and 
ending hexadecimal addresses. The maximum value for any range is >8F 
on the TMS320C10 Simulator and >FFFF on the TMS32020 and 
TMS320C25 Simulators. 


Use the C command to resume simulation. BDW is listed in the BH menu. 


ENTER COMMAND (HELP=<CR>): 
BDW <CR> 


BREAK ON DATA RAM WRITE 

ENTER THE BEGINNING ADDRESS (IN HEX) 
5 <CR> 

ENTER THE ENDING ADDRESS (IN HEX) 

F <CR> 


ENTER COMMAND (HELP=<CR>): 


When a data RAM address within the inclusive range >5 - >F ts written to, 
the simulator stops execution after processing the write instruction. 


Use the DB command to display the breakpoint and its reference number. 
To remove the breakpoint, use the RB command. 
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BER 


Breakpoint on an Error Condition 


Description 


Example 
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BER lists eight breakpoints (shown in the following example) that may be 
toggled on or off. BER is in the BH menu. 


The simulator prompts for the error condition number to be changed. If the 
error condition is ON, it will be toggled off. If OFF, the condition will be 
toggled on. Entering a carriage return terminates the BER command. 


If the error condition is listed as ON, it causes a break in the simulation. 
On the TMS320C10 Simulator, all conditions default to OFF except error 
conditions 5 and 8.. Error condition 5 reflects a hardware limitation, and 
error condition 8 defaults to ON because attempted writes to on-chip ROM 
are impossible. On the TMS320C25 Simulator, all conditions default to 
OFF. Use the C command to resume simulation. 


This display appears for the TMS320C10 Simulator. 


ENTER COMMAND (HELP=<CR>) : 


BER <CR> 

BREAKON ERROR CONDITIONS 
1) STACK OVERFLOW = OFF 2) STACK UNDERFLOW = OFF 
3) AR OVERFLOW = OFF 4) AR UNDERFLOW = OFF 
5) MPY 8000 X 8000 = ON 6) ACC OVERFLOW = OFF 
7) PROGRAM MEMORY ADDRESS >1535 = OFF 
8) ATTEMPTED TBL WRITE INTO CHIP ROM = OFF 


ENTER CONDITION # TO BE TOGGLED 
4 <CR> 


ENTER CONDITION # TO BE TOGGLED 
<CR> 


ENTER COMMAND (HELP=<CR>): 
Auxiliary register underflow or a multiply of >8000 by >8000 halts simu- 


lator execution. However, if an auxiliary register overflow occurs, the sim- 
ulator continues executing since the break on AR OVERFLOW is still off. 


The DB command does not list breakpoints set by the BER command. 


Breakpoint on an Error Condition BER 


Example This display appears for the TMS32020/C25 Simulator. 
COMMAND: BER <CR> 


breakon ERROR conditions 


1) STACK OVERFLOW = O 
2) STACK UNDERFLOW = OFF 
3) OVERFLOW =O 
O) Return to Main 


Enter condition # to be toggled 


Jus 
A 
Q 
ve) 
V 


Enter condition # to be toggled 


lo 
A 
Q 
ye) 
Vv 


COMMAND: 


The DB command does not list breakpoints set by the BER command. 


BH 


Description 


Example 1 


Example 2 
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The BH command displays the available breakpoint commands. A maxi- 
mum of 20 breakpoints may be assigned at any one time. The BH com- 
mand is listed in the DM menu. 


This display appears for the TMS320C10 Simulators. 


ENTER COMMAND (HELP=<CR>) : 
BH <CR> 


BREAKPOINT COMMANDS ARE: 


BDP = BREAKPOINT ON DATA PATTERN WHEN R/W FROM/TO 

DATA RAM 

BDR = BREAKPOINT ON DATA RAM READ 

BDRW = BREAKPOINT ON DATA RAM READ AND WRITE 

BDW = BREAKPOINT ON DATA RAM WRITE 

BER = BREAKPOINT ON AN ERROR CONDITION 

BIAQ = BREAKPOINT ON INSTRUCTION ACQUISITION 

BPP = BREAKPOINT ON DATA PATTERN WHEN READ FROM 
PROGRAM ROM 

BPR = BREAKPOINT ON PROGRAM ROM READ 

DB = DISPLAY ALL BREAKPOINTS 

RB = REMOVE A BREAKPOINT 


ENTER COMMAND (HELP=<CR>): 


Any command may be entered after the ENTER COMMAND (HELP=<CR>) 
prompt. | 


This display appears for the TMS32020/C25 Simulator. 
COMMAND: BH <CR> 


BREAKPOINT COMMANDS ARE: 


BDP :bkpt on data pattern when r/w from/to data 
:Ram 

BDR:BDW :bkpt on data RAM READ:WRITE 

BDRW :bkpt on data RAM READ and WRITE 

BER :bkpt on an ERROR condition 

BIAQ :bkpt on Instruction ACQuisition | 

BPP :bkpt on Data Pattern when read from Program 

| : ROM 

BPR sbkpt on program ROM read 

DB :display all breakpoints 

RB :remove a breakpoint 

COMMAND : 


Any command may be entered after the COMMAND: prompt. 


Breakpoint on Instruction Acquisition BIAO 


Description 


Example 171 


BIAQ suspends simulator execution when an instruction is fetched from a 
given location in program memory. The system prompts for the beginning 
hexadecimal address. BIAQ is listed in the BH menu. 


ENTER COMMAND (HELP=<CR>): 
BIAQ <CR> 


BREAK ON INSTRUCTION ACQUISITION 
ENTER THE ADDRESS (IN HEX) 
10 <CR> 


ENTER COMMAND (HELP=<CR>): 


When an instruction is fetched from program memory location >10, the 
simulator stops execution after processing the instruction. 


Use the DB command to display the breakpoint and its reference number. 
To remove the breakpoint, use the RB command. 
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BIO | | Modify/inspect 1/O Branch Control 


Description — BIO allows you to inspect and change BIO, the I/O branch control pin, used 
to monitor peripheral device status. BIO is useful as an alternative to an 
interrupt when it is necessary not to disturb time-critical loops. BIO is in 
the RH menu. 


BIO may have one of the values listed in Table 3-3. 
Table 3-3. BIO Value and Results 


Result 


Performs a branch when the BIOZ instruction 
occurs in the program. 


1 Increments PC to the next instruction. 


Example ENTER COMMAND (HELP=<CR>: 
BIO <CR> | 
PRESENT VALUE OF THE I/O BRANCH CONTROL 
1 | 3 | 
ENTER NEW VALUE (0,1) 
0 <CR> 


ENTER COMMAND (HELP=<CR>): 
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Breakpoint on Data Pattern 


When Read from Program ROM 


Description 


Example 


BPP 


BPP halts simulator execution when a specified bit pattern is read from 
program ROM. The system prompts for a pattern of ones, zeros, and Xs. 
The Xs correspond to the don’t care state. Be sure to use Xs, not blanks; 
when a blank is entered for a bit position, the following bits are also treated 


as blanks, thus producing a bad bit pattern. 


Use the C command to resume simulation. BPP is listed in the BH menu. 


ENTER COMMAND (HELP=<CR>): 
BPP <CR> 


BREAK ON PROGRAM ROM READ 

ENTER BIT PATTERN OF 16 BITS (0,1,X) 
FIRST BIT IS MSB 

Q10100001XXXXXXX <CR> 


THE 16 BITS ENTERED ARE: 
1S. 4 LS A. oa IO eS ee Se a 


O 1 0 1 0 0 0 0 1 X% X X KX K K XK 


ENTER COMMAND (HELP=<CR>): 


When an LST indirect instruction (>50XX) is read from program ROM, the 


simulator stops execution after processing the instruction. 


The simulator only looks at the first word of a two-word instruction (such 


as a branch instruction). 


Use the DB command to verify that the breakpoint has been set. 
RB command to remove breakpoints. 


Use the 
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BPR ae Breakpoint on Program ROM Read 


Description BPR suspends simulator execution when a program ROM address within 
an address range is read from. The system prompts for the beginning and 
ending héxadecimal addresses. 


Use the C command to resume simulation. BPR is listed in the BH menu. 


Example ENTER COMMAND (HELP=<CR>): 
BPR <CR>_ 


BREAK ON PROGRAM ROM READ 
ENTER THE BEGINNING ADDRESS (IN HEX) 
1 <CR>: | 

ENTER THE ENDING ADDRESS (IN HEX) 

F <CR> | | 


ENTER COMMAND (HELP=<CR>) : 
When a program ROM address is read in the inclusive range >1 - >F, the 
simulator stops execution after processing the instruction. 


Use the DB command to verify that the breakpoint has been set. Use the 
RB command to remove breakpoints. 
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Continue the Simulation C 


Description 


Example 


C resumes simulation after a break or interruption. The C command is listed 
in the DM menu. Simulation may be interrupted by: 


Encountering a breakpoint. 
Branching to self. 


Reaching the limit on the number of instructions that may be executed 
(NB command). 


Entering <CNTRL-C> on VAX/VMS systems. 


Pressing any key on MS/PC-DOS systems running the TMS320C10 
Simulator. 


Entering <CNTRL-Y> on MS/PC-DOS_ systems running the 
TMS32020/C25 Simulators. 


Like the SS command, the C command automatically implements the ST 
command, displaying the various register values when simulation termi- 
nates. 


ENTER COMMAND (HELP=<CR>): 
Cc <CR> 


After the simulation is interrupted, the simulator displays the current status 
of the registers (see the ST command for sample displays). 


ENTER COMMAND (HELP=<CR>): 


CC Modify/Inspect Clock Counter 


Description CC allows you to inspect and change the clock counter value. The clock 
counter counts the number of clock tics (from CLKOUT, equal to CLKIN 
+4) occurring within the program. When used with single-step execution, 
the clock counter is useful in debugging time-critical portions of a program. 
CC is listed in the RH menu. 


Example ENTER COMMAND (HELP=<CR>): 
CC <CR> 


PRESENT VALUE FOR CLOCK COUNTER 

> 50 

ENTER A NEW VALUE FOR THE CLOCK COUNTER (IN HEX) 
10 <CR> 


ENTER COMMAND (HELP=<CR>): 


To verify the modification, repeat the CC command or enter the ST com- 
mand. Use the Z command to clear the clock counter. 


Modify/Inspect RAM Configuration 
Control Bit (TMS32020/C25) CNF 


Description CWNF allows you to inspect and change status register ST1’s CNF bit (the 
RAM configuration control bit). This configures the on-chip memory block 
BO as either data RAM or program ROM. Selecting block BO as data RAM 
is the default; this can be accomplished by entering <O> or a carriage re- 
turn. CNF is in the TMS32020 and TMS320C25 STH menu. 


Example This display appears for the TMS32020/C25. 
COMMAND: CNE <CR> 
Present value of ram configuration control bit : 0 
O - Onchip memory block bO is Data RAM 
1 - Onchip memory block bO is Program ROM 
Enter new value : 1 <CR> | 


COMMAND: 
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CY 
Description 


Example 
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Modify/Inspect Carry Bit (TMS320C25) 


CY allows you to inspect and change the carry bit in the ST1 status register. 
Entering a carriage return leaves the value unchanged. CY is listed in the 
STH menu. | 


COMMAND: CY <CR> 


Present value of the CARRY flag:1 
Enter new value (0,1) 2:0 <CR> 


COMMAND: 


To verify the modification, repeat the CY command or enter the ST com- 
mand to update the value in the accumulator. 


Display Breakpoints DB 


Description _ DB lists all current breakpoints set by the BDP, BPP, BDR, BDRW, BDW, 
BIAQ, BPP, and BPR commands. A listing of all breakpoint reference 
numbers, the commands used to set these breakpoints, their addresses, and 
their values is displayed. The breakpoint reference number is required to 
remove a breakpoint with the RB command. DB is in the BH menu. 


Example This display appears for the TMS320C10 and TMS32020. 


ENTER COMMAND (HELP=<CR>) : 
DB <CR> 


REF# SETBY ADDRESS VALUE 


il BDP >111100001111XXxXX 
2 BIAQ >10 
3 BDR >5 - OF 


ENTER COMMAND (HELP=<CR>) : 


This listing indicates that three breakpoints are now set by BDP, BIAQ, and 
BDR during the current simulation session. 


Example This display appears for the TMS320C25. 
COMMAND: DB <CR> 


BPR 
BPR 


Nee 
VV 
Fry. 

I 
Vv 
ke 


COMMAND: 


This listing indicates that two breakpoints are now set by BPR during the 
current simulation session. 
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DC 


Description 


Example 1 


Example 2 
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Display Control Manager (TMS320C25) 


DC allows format control of the display register. On VAX/VMS systems, 
you may choose to use decimal integer, fixed-point, or hexadecimal nota- 
tion. Each assumes one of 32 binary point positions. Note that displayed 
registers are the accumulator, auxiliary registers, P register, and T register. 


On MS/PC-DOS systems, you may choose to use decimal. integer or hexa- 
decimal notation. The machine-state display is automatically updated when 
DC is entered; the ST (display/update register status) command need not 
be entered. 


To use the DC command, enter <DC> from the command line, or <D> 
from the single-step line. DC is in the DH and UTLH menus. 


This display appears for the TMS320C25 running on a VAX/VMS system. 
COMMAND: DC <CR> 


Display control manager 

O : ARO 4 : AR4 8 : T-Reg C : AR(0-7) 
1 AR1 5 : AR5 9 : P-Reg D : Default 
2 : AR2 6 : AR6 A: ACC E : Exit 

3 AR3 7 : AR7 


O: Decimal 1 - 31: Fixed point 32: Hex 
Select NUMBER of target : 3 

Select display mode 0-32: 1 

Select NUMBER of target : E 


COMMAND: 


This display appears for the TMS320C25 running on an MS/PC-DOS sys- 
tem. -_ 


COMMAND: C <CR> 


Display control manager 
O : ARO 4 : AR4 8 : T-Reg C : AR(0-7) 


1 AR1 5 AR5 9 : P-Reg D : Default 
2 : AR2 6 : AR6 A: ACC E : Exit 
3 AR3 7 AR7 

O: Decimal 1: Hex 

Select NUMBER of target : 3 

Select display mode 0O or il: 1 

Select NUMBER of target : E 


COMMAND: 


Enable Digital Command Language 
(TMS320C25 VAX/VMS) | ~~ DCL 


Description The DCL command activates the VAX/VMS Digital Command Language 
(DCL) from the simulator. This command allows you to edit, assemble, 
link, and load from the simulator. DCL is listed in the TMS320C25 DM 
menu. 


Example 17 COMMAND: DCL <CR> 


TO RETURN TO MAIN type "EXIT" 
DCL COMMAND=> 

DIR *.MPO: 

Directory DUA2: [TEST.ASM] 


MISC.MPO;2 MISC.MPO;1 
Total of 2 files. DCL COMMAND=> 
EXIT 

COMMAND: 
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DH Display Help Menu (TMS320C25) 


Description DH displays commands that contro! notation, and display and update the 
status registers. DH is located in the TMS320C25 DM menu. 


Example This display appears for the TMS320C25. 


COMMAND: DH <CR> 
DM,<CR> : display main menu 
ST : status of registers 
DC : display controller 


COMMAND: 
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Display Main Menu | DM 


Description 


Example 


Example 


The DM command displays the general commands and other help menus. 
The TMS320C10 Simulator has four other help menus (BH, |OH, MH, and 
RH) listed in the DM menu. The TMS32020/C25 Simulator has ten other 
help menus (BH, DH, EH, |OH, MH, RH, STH, TH, TICH, and UTLH). The 
menus list commands according to function. 


Any command from the menus may be executed any time the ENTER 
COMMAND (HELP=<CR>) prompt appears. Entering a carriage return after 
this prompt displays the main menu. 


This display appears for the TMS320C10. 


ENTER COMMAND (HELP=<CR>): 
DM <CR> 


AVAILABLE COMMANDS ARE: 


BH = BREAKPOINT HELP 
DM <CR> = DISPLAY MAIN MENU 

DT = DISPLAY THE TRACE BUFFER 

EX = EXECUTE COMMANDS FROM A GIVEN FILE 
IOH = I/O HELP 

OF = SELECT JOURNAL FILE 

L = LOAD NEW OBJECT FILE 

MH = MODIFY/INSPECT MEMORY HELP 

NB = NUMBER OF INSTR TILL BREAK 

O = QUIT SIMULATION | 

Rc = RUN OR CONTINUE SIMULATION 

RH = MODIFY/INSPECT REGISTERS/FLAGS HELP 
RS = RESET SIMULATOR 

Ss = SINGLE-STEP EXECUTION 

ST = STATUS OF REGISTERS 

STR = SAVE THE TRACE BUFFER 

TIC = NUMBER OF CLOCK TICS TILL INTERRUPT 
TR = TOGGLE TRACE MODE (ON OR OFF) 

Z = ZERO CLOCK COUNTER 

ZTIC = DISABLES THE TIC COMMAND 


ENTER COMMAND (HELP=<CR>): 
This display appears for the TMS32020/C25. 
COMMAND: DM <CR> 


AVAILABLE COMMANDS ARE: 


TH : Trace help UTLH: Utilities help 
BH : Breakpoint help DCL : Activate DCL 
EH : Execution help 

MH : Memory help 

RH :.Registers/Flags help 

DH : Display help 


IOH : I/O help | 
TICH: Interrupt/Timing help 
STH : Status register/pin help 


COMMAND : 
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DP 


Description 


Example 7 
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Modify/Inspect Data Memory Page Pointer 


DP displays and allows modification of the data memory page pointer. The 
TMS32020 and TMS320C25 Simulators expect a decimal number from 0 
to 511. For the TMS320C10 Simulator, DP may have one of the values 
listed in Table 3-4. DP is in the STH menu. 


Table 3-4. Data Page Pointer Values for the TMS320C10 


Simulator 
0 | Page = 0, words 0-127 are referenced. 


Page = 1, words 128-143 are referenced. 


ENTER COMMAND (HELP=<CR>): 
DP <CR> 


PRESENT VALUE OF THE DATA MEMORY PAGE POINTER 


z} 
ENTER NEW VALUE 
OQ <CR> 


ENTER COMMAND (HELP=<CR>): 


To determine the status of the data memory page pointer, use the ST com- 
mand or repeat the DP command. 


Display Trace Buffer 


DM menu and 


DT 


in the 


Description DT displays the trace buffer. The trace mode must be set to ON for the trace 
buffer contents to be displayed (the TR command sets the trace mode). 
DT is listed in the TMS320C10 Simulator 
TMS32020/C25 Simulator TH menu. 
Example This example is for the TMS320C10 Simulator. 
ENTER COMMAND (HELP=<CR>): 
DT <CR> 
PC= 1 ACC= 2 ARO= FF ARI= O 
PC= 2 ACC= 4 ARO= CDARI= O 
PC= 3 ACC= 6 ARO= A8 ARI= O 
PC= 6 ACC= 8 ARO= 10 AR1= 0 
PC= 7 ACC= 10 ARO= 10 AR1= C6 
ENTER COMMAND (HELP=<CR>): 
Example This example is for the TMS32020/C25 Simulator. 


COMMAND: DT <CR> 


PC=0001 ACC=00000002 
ARO=OOFF AR1=0000 
| AR4=0000 AR5=0000 

PC=0002 ACC=00000004 
ARO=O00CD AR1=0000 
AR4=0000 AR5=0000 

PC=0003 ACC=00000006 
ARO=O0A8 AR1=0000 
AR4=0000 AR5=0000 


- PC=0006 ACC=00000008 


ARO=0010 AR1=0000 
AR4=0000 AR5=0000 
PC=0007 ACC=O00000010 
ARO=0010 AR1=00C6 
AR4=0000 AR5=0000 


COMMAND : 


AR2=0000 


AR6=0000 


AR2=0000 
AR6=0000 


AR2=0000 
ARo=0000 


AR2=0000 


ARo=0000 


AR2=0000 
AR6=0000 


AR3=0000 
AR7=0000 


AR3=0000 
AR7=0000 


AR3=0000 
AR7=0000 


AR3=0000 
AR7=0000 


AR3=0000 
AR7=0000 


The register values are expressed in hexadecimal. A warning appears at the 


beginning of the display if the trace exceeds 256 states. 
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Specify Wait Cycles 
DWAIT | for External Data Memory (TMS32020/C25) 


Description DWAIT selects the number of wait cycles for external data memory response 
to provide a more flexible and accurate timing analysis. DWAIT is in the 
TMS32020 and TMS320C25 Simulator TICH menu. | 


Example 17 ENTER COMMAND (HELP=<CR>): 
DWAIT <CR> 


PRESENT VALUE OF DWAIT IS 
0 


ENTER NEW VALUE (0 - 99) 
2 <CR> 


ENTER COMMAND (HELP=<CR>) : 
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Execution Help Menu (TMS320C25) EH 


Description 


Example 


EH displays commands that control notation, and display and update the 
status registers. EH is located in the TMS320C25 DM menu. 


This display appears for the TMS320C25. 


COMMAND: 


R/C 
SS 
EX 
L 
LC 
NB 
RS 
SIM 


Q 


COMMAND: 


EH <CR> 


Run or Continue simulation 

Single step 

execute commands from a given file 
load new object file 

load new COFF file 

number of instr till break 

reset Simulator 

change simulator mode 

quit simulation 
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ERA Expand RAM and ROM (TMS320C10) 


Description ERAM expands the size of the RAM and ROM to allow simulation of the 
TMS320C15, TMS320E15, TMS320C17, and TMS320E17. RAM is ex- 
panded from 144 words to 256 words, and ROM is expanded from 1.5K to 
4K. 


Example Assume that the Simulator has been initialized to be in microcomputer 
mode. | 


ENTER COMMAND (HELP=<CR>): 
ERAM <CR> 


YOU ARE IN THE MICROCOMPUTER MODE (ADDR 0-4096, ON 
CHIP) 
RAM INCREASED TO 256 WORDS 


ENTER COMMAND (HELP=<CR>): 
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Execute Commands from Given File | | EX 


Description 


Example 


EX executes simulator commands from a journal file. EX is listed in the 
TMS320C10 Simulator DM menu and in the TMS32020/C25 Simulator 
EH menu. 


ENTER COMMAND (HELP=<CR>): 
EX <CR> 


ENTER FILE NAME 
JOURNAL.TXT <CR> 


(The commands in the file JOURNAL.TXT are displayed as they are exe- 
cuted.) 


ENTER COMMAND (HELP=<CR>): 


<CNTRL-C> may be used while running TMS320C10, TMS32020, and 
TMS320C25 Simulators on a VAX/VMS system to exit this command and 
return to the simulator prompt. <CNTRL-Y> may be used while running 
the TMS320C25 Simulator on an MS/PC-DOS system. 


FO 


Description 


Example 
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Modify/Inspect Format Bit (TMS32020/C25) 


FO displays and allows modification of the format bit. FO is listed in the 
TMS32020 and TMS320C25 Simulator STH menu. 


ENTER COMMAND (HELP=<CR>) : 
FO <CR> 


PRESENT VALUE OF THE FORMAT PIN 


O 
ENTER NEW VALUE (0 OR 1) 
1 <CR> 


ENTER COMMAND (HELP=<CR>): 


Modify/Inspect Frame Sync Mode (TMS320C25) FSM 


Description — FSM allows you to inspect and change the frame synchronization mode in 
the ST1 status register. This bit indicates whether the serial port will oper- 
ate with or without frame sync pulses. FSM is in the STH menu. 


Example COMMAND: FSM <CR> 
Present value of frame synch mode bit : 1 
Enter new value : O <CR> 
COMMAND : 
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HM 


Description. 


Example 
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Modify/Inspect Hold Mode Bit (TMS320C25) 


HM allows you to inspect and change the hold mode bit in the ST1 status 
register. HM is in the STH menu. 


COMMAND: HM <CR> 


Present value of hold mode bit :1 
Enter new value : Q <CR> - 8 


COMMAND : 


Modify/Inspect Interrupt Flag Register (TMS320C10) INTF 


Description 


Example 


INTF displays and allows modification of the interrupt flag register. INTF 
is listed in the TMS320C10 Simulator RH menu. 


The INTF and INTM (modify/inspect interrupt mode register) commands 
work together to determine if interrupts have occurred. INTM reflects an 
internal condition that indicates whether or not an interrupt flag may be 
serviced. The INTF and INTM value combinations that cause an interrupt 
are listed below. 


INTF INTM INTERRUPT 


0 0 NO 
0 1 NO 
4 0 YES 
1 1 NO 


ENTER COMMAND (HELP=<CR>): 
INTF <CR> 


PRESENT VALUE OF THE INTERRUPT FLAG REGISTER 
O 


ENTER NEW VALUE (0,1) 
1 <CR> 


ENTER COMMAND (HELP=<CR>): 


The interrupt flag register (INTF) value is changed to logic 1. Note that 
when simulator execution resumes, an interrupt will occur if the interrupt 
mode register (INTM) equals logic 0. 


To check the current status of the INTF register, use the ST command. 
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| | | Modify/Inspect Interrupt 
INTFS Flags (TMS32020/C25) 


Description _\NTFS allows you to inspect and change one of the three interrupt flags 
(0-2). First, a prompt appears for the interrupt flag number, and then the 
flag can be viewed or changed. INTFS is in the TMS32020 and 
TMS320C25 Simulator RH menu. 


The INTFS and INTMS value combinations that cause an interrupt are listed 
below. These combinations refer to the corresponding INTFS and INTMS 
values. For example, INTFS(1) = 1 and INTMS(2) = 1 would not cause 
an interrupt; however, INTFS(1) = 1 and INTMS(1) = 1 would cause an 


interrupt. 
INTFS INTMS 
(O-2) (0-2) INTERRUPT 
0 0 NO 
0 1 NO 
1 0 NO 
1 1 YES 
Example This display appears for the TMS32020/C25. 
COMMAND: INTFS <CR> 
Enter the IRT flg number (0 - 2) or enter "-" to terminate : 1 <CR> 
INTF1 = 0 
Enter new value (0 or 1) : 21 <CR> 
Enter the IRT flg number (0 - 2) or enter "-" to terminate : - <CR> 


COMMAND: 
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Modify/Inspect Interrupt Mode Register INTM 


Description 


Example 


INTM displays and allows modification of the interrupt flag mode register. 
INTM is found in the TMS320C10 Simulator RH menu and in the 
TMS32020 and TMS320C25 Simulator STH menu. 


The INTM and INTF (modify/inspect interrupt flag register) commands 
work together to determine if interrupts have occurred. INTM reflects an 
internal condition that indicates whether or not an interrupt flag may be 
serviced. The INTF and INTM value combinations that cause an interrupt 
are listed below. 


INTF INTM INTERRUPT 


0 0 NO 
0 1 NO 
1 0 YES 
1 1 NO 


For the TMS32020 and TMS320C25 Simulators, INTM may have one of 
the values listed in Table 3-5. 


Table 3-5. TMS32020 and TMS320C25 Interrupt Mode Register 
Values 


INTM | C—~—“‘éRswE 
he Os 24 Enables all unmasked interrupts. 
Disables all maskable interrupts. 


ENTER COMMAND (HELP=<CR>): 
INTM <CR> 


PRESENT VALUE OF THE INTERRUPT MODE REGISTER 
0 


ENTER NEW VALUE (0,1) 
CRS 


ENTER COMMAND (HELP=<CR>): 
The interrupt mode register value (INTM) is changed to logic 1. Note that 


when INTM = 1, no interrupts may occur regardless of the the interrupt flag 
register value. 


To display/update the current status of the INTM register, use the ST 
command or repeat the INTM command. 
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| Modify/Inspect Interrupt 
INTMS | Mask (TMS32020/C25) 


Description —|NTMS displays and allows modification of one of the three interrupt masks 
(0-2). The simulator first prompts for the interrupt mask number. Then, the 
mask can be changed. INTMS is listed in the TMS32020 and TMS320C25 
Simulator RH menu. | 3 


The INTFS and INTMS value combinations that cause an interrupt are listed 
below. These combinations refer to the corresponding INTFS and INTMS 
values. For example, INTFS(1) = 1 and INTMS(2) = 1 would not cause 
an interrupt; however, INTFS(1) = 1 and INTMS(1) = 1 would cause an 


interrupt. | . 
INTFS INTMS 
(0-2) (0-2) INTERRUPT 
0 0 NO 
0 1 NO 
1 0 NO 
1 1 YES 
Example __ This display appears for the TMS32020/C25. 
COMMAND: INTMS <CR> 
Enter the IRT mask number (0 - 2) or enter "-" to terminate : 1 <CR> 
INTM1 = 0 | 
Enter new value (0 or 1) L <CR> 
Enter the IRT mask number (0 - 2) or enter "-" to terminate : - <CR> 
COMMAND: 
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Input/Output Help Menu IOH 


Description The |OH menu displays all available input and output commands. IOH is 
listed in the DM menu. 


Example This display appears for the TMS320C10. 


ENTER COMMAND (HELP=<CR>): 
IOQH <CR> 


ITO HELP COMMANDS ARE: 


LF = LIST OF FILES ASSIGNED TO PORTS 
SI = SELECT INPUT PORT FILE 
RSI= RESET SELECTED INPUT PORT FILE 
SO = SELECT OUTPUT PORT FILE 


ENTER COMMAND (HELP=<CR>): 
Example This display appears for the TMS32020/C25. 


COMMAND: IOQH <CR> 


LI >: List of the files assigned to input ports 
LO : List of the files assigned to output ports 
RSI : Reset selected input port file 

SI : Select input port file 

SO : Select output port file 


RCV : Assign serial port RECEIVE channel 
XMT : Assign serial port TRANSMIT channel 
RCVC : Close serial port RECEIVE channel 
XMTC : Close serial port TRANSMIT channel 


Any command from any menu may be entered after the ENTER COMMAND 
(HELP=<CR>) prompt. 


Note: 


The RCV, XMT, RCVC, and XMTC commands are only for the 
TMS320C25 simulator. 
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Specify Wait Cycles for 
lIOWAIT External 1/0 Memory (TMS32020/C25) 


Description \|OWAIT selects the number of wait cycles for external input/output memory 
response to provide a more flexible and accurate timing analysis. [OWAIT. 
is listed in the TMS32020 and TMS320C25 Simulator TICH menu. 


Example 1 ENTER COMMAND (HELP= SCRy hs 
IOWAIT <CR> 


PRESENT VALUE OF EOE, Is 


0 
ENTER NEW VALUE (0 - 99) 
2 <CR> 


ENTER COMMAND (HELP=<CR>): 
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Select Journal File 7 JF 


Description 


Example 


Example 


Example 


The JF command creates, names, and saves a journal file. A journal file acts 
as the “keeper” of a session’s commands. After executing the JF command, 
every command within a session is recorded in the journal file until the OQ 
(quit) command is entered. A journal file (see Section 3) is useful when 
testing requires the same processes to be repeated. 


If a journal file already exists, entering a carriage return after the prompt for 
a new file name leaves the file unchanged. | 


If a journal file does not exist and a carriage return is entered after the 
prompt for a file name, the TMS320C10 VAX/VMS simulator creates a de- 
fault file called FORO8.DAT. The TMS320C10 MS/PC-DOS Simulator and 
the TMS32020/C25 VAX/VMS and MS/PC-DOS Simulators will display 
an error message. 


ENTER COMMAND (HELP=<CR>): 
JF <CR> 


A JOURNAL FILE HAS NOT BEEN CREATED 
ENTER FILE NAME 
JOURNAL .TXT <CR> 


ENTER COMMAND (HELP=<CR>) : 


This display appears when a journal file has been accessed in the current 
session. If a carriage return is entered after the prompt for the new file 
name, the simulator appends commands to the current journal file. 


ENTER COMMAND (HELP=<CR>): 
JF <CR> 


JOURNAL FILE = JOURNAL 


ENTER NEW FILE NAME 
NEWJOU.TXT <CR> 


ENTER COMMAND (HELP=<CR>): 


When the JF command is entered, the rest of the simulator session is re- 
corded in the journal file until simulation is halted with a Q (quit) com- 
mand. 


Data RAM locations >0 to >5 are to be loaded with the value >55, and the 
source program modified at least three times. To avoid loading the same 
data RAM locations each time a modification is made, a journal file is cre- 
ated using the JF command. The following display shows how the journal 
file is created. 


ENTER COMMAND (HELP=<CR>): 
JF <CR> 


A JOURNAL FILE HAS NOT BEEN CREATED 
ENTER FILE NAME 
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‘JSF 


Select Journal File 
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DATA.TEN <CR> 


ENTER COMMAND (HELP=<CR>) : 


From this point on, all commands entered until a O (quit) is issued are re- 
corded in the journal file DATA.TEN. To load data RAM locations >0 to 


>B with >55, the RAM Unodiiviinspsee individual program RAM) com- 
mand is used. 


ENTER ‘COMMAND (HELP= oc, 


RAM <CR> 
ENTER STARTING ADDRESS. (IN HEX) 
Q <CR> 
~ O. 0 
55. <CR> | Gigage the value to 55.” 
O = 55 oe 
+ <CR> *Move to the next RAM address.” 
1 = 0 
55 <CR> *Change the value to 55.” 
1 = 55 
+ <CR> *Move to the next RAM address.” 
2 = 0 
55 <CR> “Change the value to 55.” 
2= 55 
<CR> *Repeat the + option.* 
3 = 0 
55 <CR> *Change the value to 55.* 
3 = 55 
<CR> “Repeat the + option.” 
4 = 0 
55 <CR> *Change the value to 55.” 
4= 55 
<CR> *“Repeat the + option.* 
5 = 0 
55 <CR> “Change the value to 55.” 
5 = 55 
Q <CR> *Quit the RAM command.” 


ENTER COMMAND (HELP=<CR>): 
Q <CR> *End the session and create the journal file.” 


The next time these data RAM locations and values are required, simply 
execute the journal file DATA.TEN with the EX (execute) command, as 
shown below. 


ENTER COMMAND (HELP=<CR>) : 
EX <CR> 


ENTER FILE NAME 
DATA.TEN <CR> 


ENTER COMMAND (HELP=<CR>) : 


Note that the simulation commands in the sample file DATA.TEN are dis- 
played as they are executed. 


Select Journal File JF 


Journal files can be a powerful tool for improving the quality of a simulation 
session. They can be used to make |/O assignments, set sequences of 
breakpoints, set up Operating conditions, and so forth. Two known limita- 
tions exist and should be avoided. 


1) Nesting executions of journal files. For example, journal file A.TXT 
performs a few functions and executes journal file B. TXT; when A. TXT 
is executed, an error occurs because B.TXT is executed within A.TXT. 
(This is not an error on the MS/PC-DOS version.) 


2) Responding with the existing journal file name when prompted for the 
new journal file name. (This is not an error on the MS/PC-DOS ver- 
sion; however, the file will be overwritten from the point where the 
journal file name is specified.) 


On a VAX system, both of these situations halt the simulation session, re- 
turning to the host system prompt. 
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Load New Object File 


Description 


Example 1 


3-52 


L loads an object file for the simulation. Any file that is loaded into the 
simulator must be an absolute, tagged, and linked (if necessary) object file. 


Memory is not automatically initialized prior to loading an object file. If a 


file is loaded that does not overwrite the entire previous contents of mem- 
ory, a portion of the previous object file will remain in memory. 


ENTER COMMAND (HELP=<CR>): 
L <CR> 


ENTER A NEW OBJECT FILE 
NAME.OBJ <CR> 


* * * * LOADING PROGRAM "NAME.OBJ" * * * * 
ENTER COMMAND (HELP=<CR>): 


The new object file NAME.OBJ is loaded into program ROM. Future sim- 
ulations will access the program that is in the file NAME.OBJ. 


Load New COFF Files (TMS32020/C25) LC 


Description 


Example 


LC loads a Common Object File Format (COFF) file for the simulator. 


Memory is not automatically initialized prior to loading a COFF file. Ifa file 
is loaded that does not overwrite the entire previous contents of memory, a 
portion of the previous file will remain in memory. 

Command: LC <CR> 

Enter a new COFF object file: COFF.OBJ <CR> 

* * * * LOADING PROGRAM "COFF.OBJ" * * * * 


Command: 


The new COFF object file COFF.OBJ is loaded into program ROM. Future 
simulations will access the program that is in the file COFF.OBJ. 
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LF 


Description 


Example 
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List Files Assigned to Ports (TMS320C10) 


LF lists the input and output files associated with the eight input and eight 
output ports. LF is listed in the TMS320C10 Simulator I|OH menu. 


ENTER COMMAND (HELP=<CR>) : 
LF <CR> | 


Input Port # File Name 


WOU BWNHHO 
Z 
O 
Zz 
ea 


Output Port # File Name 


SOU BWNErO 
a 
O 
a 
tH 


ENTER COMMAND (HELP=<CR>): 


All of the ports and their associated files are displayed. The ports that have 
associated files are input port 3 and output port 5. 


List Files Assigned to Input Ports (TMS32020/C25) Li 


Description _ LI lists the files associated with the input ports (0-15). Enter <CNTRL-S> 
to interrupt and view the file list display. LI is listed in the TMS32020 and 
TMS320C25 Simulator |OH menu. 


Example ENTER COMMAND (HELP=<CR>): 
LI <CR> 
Input Port # File Name 
0 NONE 
1 NONE 
2 NONE 
3 NAME .INP 
4 NONE 
5 NONE 
6 NONE 
7 NONE 
8 NONE 
9 NONE 
10 NONE 
da NONE 
LZ NONE 
13 NONE 
14 NONE 
5 NONE 


ENTER COMMAND (HELP=<CR>) : 


All of the input ports and their associated files are displayed. In this exam- 
ple, input port 3 is the only port associated with a file. 
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LO List Files Assigned to Output Ports (TMS32020/C25) 


Description LO lists the files associated with the output ports (0-15). Enter 
| <CNTRL-S> to interrupt and view the file list display. LO is located in the 
TMS32020 and TMS320C25 Simulator JOH menu. | 


Example = ENTER COMMAND (HELP=<CR>): 
a LO <CR> 


Output Port # File Name 


0 NONE 
1 NONE 
2 NONE 
3 NONE 
4 NONE 
5 NAME .OUT 
6 NONE 
4 NONE 
8 NONE 
9 NONE 
10 NONE 
al NONE 
Ae NONE 
13 NONE 
14 NONE 
15 NONE 


ENTER COMMAND (HELP=<CR>): 


All of the output ports and their associated files are displayed. In this ex- 
ample, output port 5 is the only port associated with a file. 
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Load RAM Data from 


External File (TMS320C25) LRAM 
Description This command loads RAM data from a text file. It prompts for the input 


Example 


filename, starting address, and ending address in hexadecimal format, 
which will be loaded from a text file. 


You may create a file using the SRAM command, which stores the RAM 
data to an external file. The LRAM command loads the stored file into si- 
mulator memory. For this reason, the file you load using the LRAM com- 
mand must have the same format as the file created using the SRAM 
command. LRAM is in the UTLH menu. 


COMMAND: LRAM <CR> 


ENTER FILE NAME : TEXT1.TXT 
Enter STARTING address (in Hex) : 10 
Enter END address (in Hex) : 1 


To show the results of the LRAM command, the RAMH command is exe- 
cuted below. 


COMMAND: RAMH <CR> 


Enter start DATA address (in Hex) : 10 


10 19728 19731 19733 19747 19781 197 
18 20 


19796 


81 
0 
0 
0 
0 
0 
0 
0 


oS) 

00 
Ooo0o0o0 
OoOO0O000 
Ooo0o00coo 
OOO0000 
OdOO9O000 
OOOO000 
OOODO0O000 


COMMAND: 


In this display, the 19728 in address location >10 is a hexadecimal number, 
as are the other values displayed. 
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MAH 


Description 


Example 


Example 
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Modify/inspect Memory Help Menu 


The MH command displays the commands that display/modify memory lo- 


cations. MH is located in the DM menu. 


This display appears for the TMS320C10. 


ENTER COMMAND (HELP=<CR>): 
MH <CR> 


MODIFY AND INSPECT MEMORY COMMANDS ARE: 


RAM = MODIFY/INSPECT INDIVIDUAL DATA RAM LOCATIONS 
ROM = MODIFY/INSPECT INDIVIDUAL PROGRAM ROM LOCATIONS 
RAMH = DISPLAY DATA RAM IN HEX 

RAMI = DISPLAY DATA RAM IN INTEGER 

ROMH = DISPLAY PROGRAM ROM IN HEX 

ROMI = DISPLAY PROGRAM ROM IN INTEGER 


ENTER COMMAND (HELP=<CR>): 


Any command from any menu may be entered after the ENTER COMMAND 
(HELP=<CR>) prompt. 


This display appears for the TMS32020/C25. 
COMMAND: MH <CR> 


MODIFY AND INSPECT MEMORY COMMANDS ARE: 
RAM : modify individual data RAM locations 
ROM : modify individual program ROM locations 
RAMH : display data RAM in hex 
RAMI : display data RAM in integer 
ROMH : display program ROM in hex 
ROMI : display program ROM in integer 
ZRAM : zero fill RAM(#6-#FFFF) 


COMMAND: 


Any command from any menu may be entered after the COMMAND prompt. 


Number of Instructions 
Until Break (TMS320C10/C25) | NB 


Description NB suspends execution after a specified number of instructions have been 
executed. Breakpoints set with this command only affect one execution, 
and then the NB buffer is cleared. Enter <C> to resume the simulation. 
NB is listed in the TMS320C10 DM menu and in the TMS320C25 EH 
menu. 


The new number is entered as a decimal integer. If NB = O (default), this 
command has no effect. Entering a carriage return for the new value leaves 
the present value unchanged. 


Example 1 ENTER COMMAND (HELP=<CR>): 
NB <CR> 


ENTER NUMBER OF INSTRUCTIONS TILL BREAK 
5 <CR> 


ENTER COMMAND (HELP=<CR>): 
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OV 


Modify/Inspect Overflow Flag Register 


Description 


Example 
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OV allows you to inspect and change the overflow flag register value. This 


command is in the TMS320C10 Simulator RH menu and in the TMS32020 


and TMS320C25 Simulator STH menu. 
OV may be set to one of the values shown in Table 3-6. 


Table 3-6. Overflow Flag Values and Results 


POV | Rest 
ee Or No overflow or underflow has occurred. 


An overflow or underflow has occurred. The program caused 
the accumulator to exceed the positive limit, >7FFFFFFF, 
causing overfiow, or the negative limit, >80000000, causing 
underflow. 


ENTER COMMAND (HELP=<CR>) : 
OV <CR> 


PRESENT VALUE OF THE OVERFLOW FLAG REGISTER 
1 

ENTER NEW VALUE (0,1) 

Q <CR> 


ENTER COMMAND (HELP=<CR>) : 


The overflow flag is changed to a logic 0 (i.e., no overflow occurred) in this 
example. 


Use the ST command to verify the status of the overfiow flag register. 


Modify/Inspect Overflow Mode Register OVM 


Description 


Example 


The OVM command allows you to inspect and change the overflow mode 
register value. OVM is in the TMS320C10 Simulator RH menu and in the 
TMS32020 and TMS320C25 Simulator STH menu. 


OVM may be set to one of the values shown in Table 3-7. 


Table 3-7. Overflow Mode Values 


OVM|  —_— ———iRestt <a 
| 0 | Allows an overflow or underflow to occur. 
Results in saturation on an overflow or underflow. 


ENTER COMMAND (HELP=<CR>): 
OVM <CR> 


PRESENT VALUE OF THE OVERFLOW MODE REGISTER 
1 


ENTER NEW VALUE (0,1) 
OQ <CR> 


ENTER COMMAND (HELP=<CR>): 


The overflow mode is changed from a logic 1 to a logic 0. This prevents 
the accumulator from saturating on an overflow. 


Use the ST command to check the status of the overflow mode register. 


Modify/Inspect P Register 


Description 


Example 
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The P command allows you to inspect and modify the P register. P is listed 
in the RH menu. 


ENTER COMMAND (HELP=<CR>): 


P <CR> 

PRESENT VALUE OF THE P REGISTER 
> 0 

ENTER NEW VALUE (IN HEX) 

890F <CR> 


ENTER COMMAND (HELP=<CR>): 


Use the ST command to verify the status of the P register. 


Modify/Inspect Program Counter — PC 


Description 


Example 


The PC command allows you to inspect and change the program counter. 
PC ts listed in the RH menu. 


When the program counter is modified, the change is not reflected in the 
ST command output until the simulation is executed. Since the 
TMS320C10 program counter is only twelve bits, a maximum value of 
>FFF can be entered. The TMS32020 program counter and the 
TMS320C25 program counter, however, are 16 bits, so a maximum value 
of >FFFF can be entered. 


ENTER COMMAND (HELP=<CR>): 
PC <CR> 


PRESENT VALUE FOR PROGRAM COUNTER 

> 23 

ENTER A NEW VALUE FOR THE PROGRAM COUNTER (IN HEX) 
0. <CR> 


ENTER COMMAND (HELP=<CR>): 


In this example, the program counter is changed from >023 to >000; the 
simulator will begin execution at >O00. 
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PM 


Modify /Inspect Product Shift 
Mode (TMS32020/C25) 


Description 


Example 
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PM displays and allows modification of the product shift-mode field of 
status register one. PM is listed in the TMS32020 and TMS320C25 Sim- 
ulator STH menu. : 


The possible values for PM are shown in Table 3-8. 


Table 3-8. Product Shift-Mode Values and Results 


a The 32-bit product of the multiplier is loaded into the ALU with no 
shift. 
The PR output is left-shifted one bit and loaded into the ALU with 
the LSB zero-filled. 


2 The PR output is left-shifted four bits and loaded into the ALU with 
the LSB zero-filled. 


A ee PR output is right-shifted six bits and sign- extended. 


ENTER COMMAND (HELP=<CR>) : 
PM <CR> 


PRESENT VALUE OF THE PRODUCT SHIFT MODE 
fe) 


ENTER NEW VALUE (0 - 3) 
2 <CR> 


ENTER COMMAND (HELP=<CR>): 


The PR contents remain unchanged. Shifts take place when the contents 
of the PR register are transferred to the ALU. 


Specify Wait Cycles for External 
Program Memory (TMS32020/C25) PWAIT 


Description  PWAIT selects the number of wait cycles for an external program memory 
response, providing a more flexible and accurate timing analysis. PWAIT 
is listed in the TMS32020 and TMS320C25 Simulator TICH menu. 


Example ENTER COMMAND (HELP=<CR>) : 
PWAIT <CR> 
PRESENT VALUE OF PWAIT 
@) 
ENTER NEW VALUE (0 - 99) 
2 <CR> 


ENTER COMMAND (HELP=<CR>): 
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0 | oe | Quit Simulation 


Description terminates the simulation session and returns to the system prompt. Q 
is in the TMS320C10 Simulator DM menu and in the TMS32020/C25 


Simulator EH menu. 


Example . ENTER COMMAND (HELP=<CR>): 
Q <CR> 3 
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Run Simulation R 


Description 


Example 


R begins the simulation. It is located in the DM menu. After entering R, the 
simulation may be interrupted by: 


@ Encountering a breakpoint. 
@ Branching to self. 


@ Reaching the limit on the number of instructions that may be executed 
(NB command). 


VAX/VMS 


@ <CNTRL-C> halts any run mode process and returns the user to the 
simulator prompt. 


@ <ESC> halts any command mode process and returns the user to the 
simulator prompt. | 


MS/PC-DOS 


© <ESC> halts any process (run or command mode) and returns the 
user to the simulator prompt. 


Like the SS command, the R command automatically implements the ST 
command, displaying the various register values when simulation termi- 
nates. 


ENTER COMMAND (HELP= <CR>) : 
R <CR> 


After the run is completed, the simulator displays/updates the current status 
of the registers (see the ST command for sample displays). 


ENTER COMMAND (HELP=<CR>): 
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RAM 


Description 
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. 


Modify/Inspect Individual Data RAM 


RAM displays and allows modification of data RAM memory. RAM is in 
the MH menu. 


Initially, the simulator prompts for a starting address (where the scan be- 
gins). Once a beginning address is chosen, the address and contents of 
that location are displayed. 


If no address is chosen (a carriage return is entered after the first prompt), 
@® The TMS320C10 Simulator starts the scan at address location 0. 
e The TMS32020 and TMS320C25 Simulators begin the scan at the 


address location last accessed. The initial address, though, upon 
powerup or reset, is 0. 


Memory contents and locations can be displayed or modified by entering 


one of the first four commands listed below. That command can be re- 
peated as many times as necessary to complete scanning of memory. 


+ Displays the next memory address and its contents. 
- Displays the previous memory address and its contents. 


# Modifies the contents of the memory address currently displayed 
so that it contains the hexadecimal value. Memory addresses are 
limited to a range of >0 to >8F on the TMS320C10 and =>0 to 
>FFFF on the TMS32020 and TMS320C25. 


@# Displays the memory address # (where # is a valid hexadecimal 
address) and its contents, regardless of what address was previ- 
ously displayed. 


<CR> Repeats the previous + or - command. 


Q Quits the scan. 


Modify/Inspect Individual Data RAM RAM 


Example 


ENTER COMMAND (HELP=<CR>) : 
RAM <CR> 


ENTER STARTING ADDRESS (IN HEX) 
ab <C> 


“Repeat the + option.” 


“Repeat the - option.” 


II 
© Oo oO ©. -© 


10 


ARTING ADDRESS CHANGED * * * 
O 


op) 
I ed 


ENTER COMMAND (HELP=<CR>): 


RAMH 


Description 


Example 
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Display Data RAM in Hex 


RAMH displays various amounts of RAM memory in block style. The con- 


tents of each address are displayed as hexadecimal numbers. RAMH is 


found in the MH menu. 


The TMS320C10 Simulator, running on a VAX/VMS system, displays 
all the data RAM memory. The simulator requires no starting or end- 
ing address since the entire RAM is displayed. | 


The TMS320C10 Simulator, running on an MS/PC-DOS system, 
displays half.of the data RAM memory. The simulator asks if you want 
to see the first or second half of data RAM memory. 


If the ERAM command has been used, the RAMH command will also 
display the additional RAM that was created by ERAM. 


The TMS32020 and TMS320C25 Simulators, running on VAX/VMS 
or MS/PC-DOS operating systems, display selected portions of data 
RAM. The simulator prompts for the hexadecimal starting address of 
RAM memory. 


This TMS320C10 example is for a VAX/VMS system. 


ENTER COMMAND (HELP=<CR>): 


RAMH °<CR> 
0 1 Zee 8 4 5 6 7 8 9 

0 10 O 0 0 0 0 0 0 O 0 
10 20 0 © 0 0 0 O 0 0 0 
20 0 O 0 0 0 0 O 0 O 0 
30 0 0 0 0 0 © 0 O 0 0 
40 0 0 0 0 0 0 0 0 0 0 
50 0 O O 0 0 0 0 0 oO 0 
60 0 0 0 0 0 0 0 0 0 0 
70 0 0 0 0 0 0 0 0 0 0 
80 0 0 0 0 0 0 0 0 0 0 
90 0 0 0 0 0 0 0 0 0 0 
100 0 0 O 0 0 0 0 0 0 0 
110 0 0 0 0 0 0 0 0 0 0 
120 0 O 0 0 0 0 0 0 6: 0 
130 0 0 0 0 0 0 © 0 0 0 
140 0 0 0 0 0 0 0 0 0 0 


ENTER COMMAND (HELP=<CR>): 


The >10 in address location O is a hexadecimal number, as is the >20 in 


location 10. 


Display Data RAM in Hex | RAMH 


Example 


Example 


This TMS320C10 example is for an MS/PC-DOS system. 


ENTER COMMAND (HELP=<CR>): 
RAMH <CR> 


ENTER O TO DISPLAY ADDRESSES >0 - >47 
1 TO DISPLAY ADDRESSES >48 - >8F 


0: <CR> 
>>ADDRESS a | a 
0 10 0 0 0 ‘om O O 0 
8 20 0 0 O 0 0 O 0 
16 0 0 0 © ) 0 0 0) 
18 0 0 0 0 0 O O 0 
20 O O can O O O 0 ) 
28 0 0 0 O 6) 6) 0 QO 
30 0 0 0 O O 0 O 0 
38 0 @) 0 O ) O 0 0 
40 0 0 0 0 0 O 0 0 


ENTER COMMAND (HELP=<CR>) : 


The >10 in address location O is a hexadecimal number, as is the >20 in 
location 8. 


This example is for the TMS320C25 Simulator (both VAX/VMS and 
MS/PC-DOS). 


COMMAND: RAMH <CR> 


Enter start DATA address (in Hex): OQ <CR> 


e) 10 0 e) 0 0 6) 6) 0 

8 20 0 e) Q 0 e) @) QO 
10 0 6) 0 O 0 O 0 0 
18 O O Q O 0 O 6) e) 
20 e) Q 0 @) e) 0 0) 0 
28 0 O e) 0 QO e) e) Q 
30 6) O 0. 0 e) O 0 e) 
38 0 QO. QO @) 6) 0 OQ OQ 

COMMAND: 


In this example, the >10 in address location >0O is a hexadecimal number 
as is the >20 in location >8. To view data RAM values beyond those dis- 
played, re-enter the RAMH command. Respond to the prompt, “Enter 
starting address (in Hex),” with the new starting address and a 
Carriage return. The new range will then be displayed. 


RAMI 


Description 


Example 7 
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Display Data RAM in Integer 


RAMI displays various amounts of RAM memory in block style. The con- 
tents of each address are SEreee as integer numbers. RAMI ts found in 
the MH menu. | 


The TMS320C10 Simulator, running on a VAX/VMS system, displays 
all the data RAM memory. The simulator requires no starting or end- 
ing address since the entire RAM is displayed. 


The TMS320C10 Simulator, running on an MS/PC-DOS system, 
displays half of the data RAM memory. The simulator asks if you want 
to see the first or second half of data RAM memory. 


If the ERAM command has been used, the RAMI! command will also 
display the additional RAM that was created by ERAM. 


The TMS32020 and TMS320C25 Simulators, running on VAX/VMS 
or MS/PC-DOS operating systems, display selected portions of data 
RAM. The simulator prompts for the hexadecimal starting address of 
RAM memory. | 


This TMS320C10 example is for a VAX/VMS system. 


ENTER COMMAND (HELP=<CR>) : 


RAMI <CR> 
0 a 2 s 4 5 6 7 8 9 
0 16 0 0 0 0 O 6) 0 6 0 
10 32 0 0 0. 6) 0 0 6) 0 0 
20 0 0 0 0 @ 0 0 0 @ 0 
30 en 0 0 0 0 0 0 0 0 0 
40 0 0 0 0 0 0 0 0 0 0 
50 0 0 0 0 O- O 0 0 0 @ 
60 0 0 6) 0 0 0 0 O 0 0 
70 0 0 OQ 0 0 0 0 0 0 @ 
80 0 0 @ @ 0 6) O 0 0 0 
90 6) 0 0 0 0 0 @ ) 0 0 
100 0 0 0 0 0 0 0. 0 O 0 
fe Oe @) 0 0 0 0 0 0 0 @) 0 
120 0 0 O 0 26) 0 0 0 O 0 
130 0 0 0 0 0 0 0 0 0 0 
140 0 0 0 0 0 0 0 0 @ 0 


ENTER COMMAND (HELP= <CR>): 


The 16 in address location 0 is an integer number, as is s the 32 in location 


10. 


Display Data RAM in Integer 


Example 2 


Example 3 


This TMS320C10 example is for an MS/PC-DOS system. 


ENTER COMMAND (HELP=<CR>): 
RAMI <CR> 


ENTER O TO DISPLAY ADDRESSES >0 - >47 
1 TO DISPLAY ADDRESSES >48 - >8F 

0 <CR> 

>> ADDRESS 


8 3 


NO 

0 
fe 
ODDODOOONDO 
OOODCOO000 
OOOO OCO0O 
ODODOO0000 
COOOCOOO00 


ENTER COMMAND (HELP=<CR>): 


ODOOOO0000O 


OOdOOO0O000 


RAMI 


OOOOO0000 


The 16 in address location >0 is an integer number, as is the 32 in location 


>8. 


This example is for the TMS32020/C25 Simulator (both VAX/VMS and 


MS/PC-DOS). 
COMMAND: RAMI <CR> 
Enter starting address (in Hex): O <CR> 


e) 16 QO 
8 32 


N 

0O 
Ooo00o0 
OOOO0O000 
OODOOOO000 
OdOodO0000 
OOOO0000 
OoOd00000 


COMMAND: 


OOd000000 


OOODO0O000O0 


we 16 in address location >0 is an integer number as is the 32 in location 
>. 
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RB i _ Remove Breakpoint 


Description RB removes breakpoints. RB prompts for the reference number of the 
ae a -- -breakpoint to be removed. The DB command displays breakpoints and their 
reference numbers. RB is listed in the BH menu. 


When a breakpoint is removed, all remaining breakpoints are automatically 
resequenced, unless the last breakpoint is the only one deleted. If more 
than one RB command is performed in the same session, the reference 
_ number for each Bicanpolt will enangs as. each RB command Is completed. 


Example 1. ENTER COMMAND (HELP= <CR>) : 
. 3 DB <CR> | 


REF# SET BY ADDRESS — "VALUE 


ee eee eee meee ee cows suse ——_ oe an ene ae eee ee eee ome . — we eee ne ae 


ab BDP ST TPIO0000 111 Xxxx 
2 BIAQ >10 
3 BDR >5 - >F 


ENTER COMMAND (HELP=<CR>) : 
RB <CR> 


ENTER A BREAKPOINT REFERENCE NUMBER 
2 <CR> 


BREAKPOINT DELETED 
BIAQ > 46 


ENTER COMMAND (HELP=<CR>): 
DB <CR> 


REF# SET BY ADDRESS VALUE 


1 BDP >LL1LLOOOOLLLIXxXxXx 
2 BDR 2H. SOF 


ENTER COMMAND (HELP=<CR>): 


This example deletes breakpoint #2 at address >10, created by the BIAQ 
command. 
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Assign RCV Channel to File (TMS320C25) : RCV 


Description 


Example 


RCV assigns a serial port (RCV) channel to a specified file. The simulator 
prompts for the number of clock tics per sample (which is per word or per 
byte, depending upon the mode in effect), read from the input file. The data 
is produced in hexadecimal ASCII format. RCV is in the TMS320C25 IOH 
menu. 


If the channel to the ports is not specified, no interrupt will occur in the 
simulator. When no interrupt occurs, the simulation speed accelerates. If 
the channel to the ports is specified, the simulator displays the serial port 
register in greater brightness than before. When the input stream data is 
exhausted, the file is automatically closed. The constant "FFFF” appears in 
normal brightness. 


COMMAND : RCV <CR> 

Enter RCV data file name : TEXT1.TXT 
Min RCV IRT cycle (x100) = 16 when FO=1 
Min RCV IRT cycle (x100) = 32 when FO=0 
Enter RCV IRT cycle (x100 nsec): 32 


serial port RCV channel assigned. 


COMMAND : 


RCVC _ Close RCV Channel File (TMS320C25) 


Description RCVC closes the RCV channel file. 
Example COMMAND: RCVC <CR> 
serial port RCV channel closed. 


COMMAND : 
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Modify/Inspect Registers/Flags Help Menu 


Description 


Example 


Example 


RH 


RH displays the commands that display/modify registers and flags. RH is 
listed in the DM menu. 


This display appears for the TMS320C10. 


ENTER COMMAND (HELP=<CR>): 


RH <CR> 


MODIFY REGISTERS/FLAGS COMMANDS ARE: 


ACC 
AR 
ARP 
BIO 
ce 
DP 
INTF 
INTM 
OV 
OVM 
P 

PC 
SK 

a 


Hon W WW Te WW te db Wed ab a 


MODIFY/INSPECT 
MODIFY/INSPECT 
MODIFY/INSPECT 
MODIFY/INSPECT 
MODIFY/INSPECT 
MODIFY/INSPECT 
MODIFY/INSPECT 
MODIFY/INSPECT 
MODIFY/INSPECT 
MODIFY/INSPECT 
MODIFY /INSPECT 
MODIFY/INSPECT 
MODIFY/INSPECT 
MODIFY/INSPECT 


ENTER COMMAND (HELP=<CR>): 


ACCUMULATOR 

AUXILIARY REGISTERS 
AUXILIARY REGISTER POINTER 
I/O BRANCH CONTROL 

CLOCK COUNTER 

DATA MEMORY PAGE POINTER 
INTERRUPT FLAG REGISTER 
INTERRUPT FLAG MODE REGISTER 
OVERFLOW FLAG REGISTER 
OVERFLOW MODE REGISTER 

P REGISTER 

PROGRAM COUNTER 

STACK 

T REGISTER 


This display appears for the TMS32020/C25. 


COMMAND: RH <CR> 
Modify/Inspect 
ACC : Accumulator 
P : P register 
PC Program Counter 
SK Stack 
TINT Timer IRT flg 
INTFS Irt flags(1-2) 
BIO T/O branch CTL 
COMMAND: 


: AUX Registers 
T : T register 


RPTC RePT Counter 
CC Clock Counter 
TINTM Timer IRT Mask 
INTMS IRT masks(0-2) 


Any command may be entered after the COMMAND: prompt. 


For all commands in the RH menu, entering a carriage return after the EN- 
TER NEW VALUE prompt leaves the present register or flag value un- 


changed. 
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ROM 


Description 
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Modify/Inspect Individual Prog ROM Locations 


ROM allows you to inspect and change program ROM memory. ROM is 
listed in the MH menu. 


Initially, the simulator prompts for a starting address (where the scan be- 
gins). Once a beginning address is chosen, the address and contents of 
that location are displayed. !f no address is chosen (a carriage return is 
entered after the first prompt), | 


® The TMS320C10 Simulator starts the scan at address location 0. 


@ The TMS32020 and TMS320C25 Simulators begin the scan at the 
address location last accessed. The initial address, though, upon 
powerup or reset, is 0. 


Memory contents and locations can be displayed or modified by entering 
one of the first four commands listed below. That command can be re- 
peated as many times as necessary to complete scanning of memory. 


+ Displays the next memory address and its contents. 
- Displays the previous memory address and its contents. 


# Modifies the contents of the memory address currently displayed — 
so that it contains the hexadecimal value. Memory addresses are 
limited to range of >0 to >8F on the TMS320C10 and =>0 to 
>FFFF on the TMS32020 and TMS320C25. 


@# Displays the memory address # (where # is a valid hexadecimal 
address) and its contents, regardless of what address was previ- 
ously displayed. 


<CR> Repeats the previous + or - command. 


Q Quits the scan. 


Note: 


The ROM command does not inspect or modify internal Program RAM 
or external Program memory. After a CNFP instruction (or a CNF=1 
command), the ROM command continues to display external ROM at 
a block bO location. To inspect or modify block bO under these condi- 
tions, the RAM command must be used. However, the display com- 
mands (ROMH and ROMI) will display Program memory locations 
and/or RAM locations in block bO when the CNF bit is set to 1 and the 
address is in the range >FFOO to >FFFF. 


Modify/Inspect Individual Prog ROM Locations 


Example 7 


ENTER COMMAND (HELP=<CR>) : 
ROM <CR> 


ENTER STARTING ADDRESS (IN HEX) 
44 <CR> 


Ss 
Ds 
li 


O 


“Repeat the + option.” 


*Repeat the - option.” 


0 
= 0 
0 
QO 


* * * STARTING ADDRESS CHANGED * * * 
111 = 0 
Q <CR> 


ENTER COMMAND (HELP=<CR>): 


ROM 


ROMH 


Display Program ROM in Hex 


Description 


Example 
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ROMH displays a selected portion of program ROM memory in block style. 
The contents of each address are displayed as hexadecimal numbers. 
VAX/VMS systems display 152 consecutive words of program ROM. 
MS/PC-DOS systems display 72 consecutive words of program ROM. 
ROMH is found in the MH menu. 


This example is for an MS/PC-DOS system running the TMS320C10 Sim- 
ulator. 


ENTER COMMAND (HELP= ee 


ROMH <CR> 

ENTER STARTING ADDRESS (IN HEX) 

CO <CR> 

>>PC 
GO 10 0 0 0 0 0 0 0 
C8 20 0 0 0 0 0. 0 0 
DO 0 0 0 0 0 0 0 0 
D8 0 0 0 0 0 0 0 0 
EO 0 0 0 O 0 O 0 0 
E8 0 0 0 0 O 0 0 0 
FO 0 0 0 0 O 0 0 0 
F8 0 0 0 O @ 0 O 0 
100 0 0 @) 0 0 0 0 0 


ENTER COMMAND (HELP=<CR>): 


The >10 in location >CO is a hexadecimal number as is the >20 in location 
>C8. Note that the addresses are displayed in hexadecimal. 


Display Program ROM in Hex ROMH 


Example 


This example is for a VAX/VMS system or an MS/PC-DOS system running 
the TMS32020/C25 Simulator. 


COMMAND: ROMH <CR> 


Enter start PROGRAM address (in Hex): OQ <CR> 
0 10 0 0 0 0 0 0 0 
8 20 0 0 0 0 0 0 0 
10 0 0 0 0 0 0 0 0 
18 0 0 0 0 0 0 0 0 
20 0 0 0 O 0 0 0 0 
28 0 0 0 0 0 0 0 0 
30 0 0 0 0 0 0 0 0 
38 0 0 0 0 0 0 0 0 

COMMAND : 


The >10 in location >O is a hexadecimal number as is the >20 in 
location>8. Note that the addresses are displayed in hexadecimal. To view 
values beyond those displayed, re-enter the ROMH command. Respond to 
the prompt, "Enter starting address (in Hex),” with the new 
starting address and a carriage return. The new range will then be dis- 
played. 


ROMI 


Description 


Example 7 
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Display Program ROM in Integer 


ROMI displays a selected portion of program ROM memory in block style. 
The contents of each address are displayed as integer numbers. VAX/VMS 
and MS/PC-DOS systems display 152 consecutive words of program 
ROM. ROM is found in the MH menu. 


_ This example is for an MS/PC-DOS system running the TMS320C10 Sim- 


ulator. 


ENTER COMMAND (HELP= <CR>) : 


ROMI <CR> 

ENTER STARTING ADDRESS (IN HEX) 

co <CR> 

>>PC 
CO 16 0 0 0 0 0 0 0 
C8 32 O 0 0 0 0 0 0 
DO 0 0 0 0 0 0 0 0 
D8 0 0 0 0 0 0 0 0 
EO 0 0 O- 0 0 0 0 0 
E8 0 0 0 0 0 O 0 0 
FO 0 @) @) O 0 0 0 0 
F8 0 0 0 0 0 0 0 0 
100 0 0 @) 0 0 0 O 0 


ENTER COMMAND (HELP=<CR>): 


The 16 in location >CO is an integer, as is the 32 in location >C8. 


Display Program ROM in Integer ROMI 


Example 2 


This example is for a VAX/VMS system or an MS/PC-DOS system running 
the TMS32020/C25 Simulator. 


COMMAND: ROMI <CR> 


Enter start. PROGRAM address (in Hex): O <CR> 
0 16 0 0 0 6) O 0 O 
8 32 0 6) O O O 0 0 
10 0 0 0 0 0 0 0 0 
18 0 0 0 0 0 © 0 0 
20 0 0 0 O O 0 O 0 
23 e) O 6) 0 O O O 0 
30 O 0 O 0 0 6) O O 
38 0 O O O O me O 0 
COMMAND: 


The 16 in location >O is an integer number as is the 32 in location >8. Note 
that the addresses are displayed in hexadecimal. To view values beyond 
those displayed, re-enter the ROMI command. Respond to the prompt, 
“Enter starting address (in Hex),” with the new starting ad- 
dress and a Carriage return. The new range will then be displayed. 
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RPTC 


Description 


Example 7 
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Modify/Inspect Repeat Counter (TMS32020/C25) 


RPTC displays and allows modification of the repeat instruction. counter, 
which tabulates the number of times an instruction has been repeated. 
RPTC is helpful in streamlining instructions. RPTC is listed in the 
TMS32020 and TMS320C25 Simulator RH menu. 


ENTER COMMAND (HELP=<CR>): 
RPTC <CR> 


PRESENT VALUE OF REPEAT INSTRUCTION COUNTER 
O 


ENTER NEW VALUE (0 - >FF, IN HEX) 
Cc <CR> 


ENTER COMMAND (HELP=<CR>): 


Reset Simulator | RS 


Description 


Example 


RS causes a reset. RS is located in the TMS320C10 Simulator DM menu. 
In the TMS32020/C25 Simulator, RS is in the EH menu. For the 
TMS320C10, TMS32020, and TMS320C25 Simulators, the reset: 

@ Loads the program counter with zero (PC = QO). 


@ Sets the interrupt mode register to 1 to disable interrupts (INTM = 
1). 


@ Clears any pending interrupts (INTF = 0). 

Also, the reset for the TMS32020 and TMS320C25 Simulators: 

e Loads the CNF bit with 0, configuring all RAM as data memory. 
6 Clears RPTC. 

© Sets status bit OV to zero and status bit XF to 1. 


@ Sets timer register TIM to >FFFF. 


RS does not start the simulation. Use the R or the C command to continue 
simulation after a reset. 


ENTER COMMAND (HELP=<CR>) : 
RS <CR> 


ENTER COMMAND (HELP=<CR>): 
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RSI 


Reset Selected Input Port File 


Description 


Example 


Example 


RSI resets an input-port file so that data is taken from the top of the file 
(i.e., the pointer is repositioned to the top of the file). RSI is located in the 
IOH menu. 


This display appears for the TMS320C10. 


ENTER COMMAND (HELP=<CR>) : 
RSI <CR> 


ENTER THE INPUT PORT (0,...,7) 
2 <CR> 


INPUT PORT FILE # 2 HAS BEEN RESET 
ENTER COMMAND (HELP=<CR>): 
This display appears for the TMS32020 and TMS320C25. 


ENTER COMMAND (HELP=<CR>) : 
RSI <CR> 


ENTER THE INPUT PORT (0,...,15) 
2 <CR> 


INPUT PORT FILE # 2 HAS BEEN RESET 


ENTER COMMAND (HELP=<CR>): 


The file associated with port 2 has been reset. It is not necessary to use this 
command when the end of a file is reached as the simulator provides an 
autowrap feature. Once the end of a file is reached, any further attempt to 
read from the file automatically resets to the top of that file. 


Generate Test Data (TMS320C25 VAX/VMS) SGN 


Description SGN uses the sine function to generate test data in the RAM on VAX/VMS 
systems. The simulator prompts for information to determine where the 
data table will begin in the RAM and how the data pattern will appear. The 
default values for SGN are shown in Table 3-9. SGN is in the TMS320C25 
UTLH menu. : 


Table 3-9. Default Values for Generated Test Data in RAM 


[starting address [| hexadecimal [0 
eyeles ————~* decimal dP 
Tstepsize «decimal i 


Example 7 


COMMAND: SGN <CR> 


SIN(x) function generator 
start address in hex (default = 0) 
period (default = 128) 
cycles (default = 1) : 
step size (default = 1) : 
max amplitude (default = 8192) 


COMMAND: 


In this example, default values were accepted by entering carriage returns. 
Note that: 
1) |The number of words generated is found by this formula: 
= (period x cycles) - 1. 
2)  Fori = 1 to period: 
RAM (start—addr + i-1) = max—ampl[SIN (2n x (i-1)/period)] 
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SI | Select Input Port File 


Description — Sl associates an existing file with an input port. If a file is already associ- 
7 ated with the specified port, the new file overrides the old file. The associ- 
ated input files can be displayed using the LF command on the 
TMS320C10 and the LI command on the TMS32020 and TMS320C25. 
The SI command can be found in the I|OH menu. 


Whenever an IN instruction is executed, data is read from the file associated 
with the port. If no file has been assigned, the simulation is suspended, and 
the simulator prompts for input. Once the input is supplied, simulation re- 
sumes. 


Example This display appears for the TMS320C10. 


ENTER COMMAND (HELP=<CR>) : 
SI <CR> 


ENTER THE INPUT PORT (0,...,7) 
3 <CR> 

ENTER FILE NAME FOR INPUT 
NAME.INP <CR> 


ENTER COMMAND (HELP=<CR>): 
Example This display appears for the TMS32020 and TMS320C25. 


ENTER COMMAND (HELP=<CR>) : 
SI <CR> 


ENTER THE INPUT PORT (0,...,15) 
3 <CR> 

ENTER FILE NAME FOR INPUT 
NAME.INP <CR> 


ENTER COMMAND (HELP=<CR>): 


The file NAME.INP is now associated with input port 3. Any data input 
through port 3 is read from the file NAME.INP. 
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Simulator Mode Command (TMS32020/C25) SIM 


Description 


Example 7 


SIM allows the simulator to be changed from the TMS320C25 simulator to 
the TMS32020 simulator and back again. SIM also allows the user to select 
either the microProcesser mode or the microComputer mode. 


The following prompt appears for the SIM command. 
Command: SIM 


Present simulation mode: 3 = TMS320C25 (MP/MC pin = mi- 
croprocessor mode) 


1)  TMS32020 
2) TMS320C25 (MP/MC 


microComputer = 
3)  TMS320C25 (MP/MC = 


microPprocessor 


0) 

0) 
Enter new Simulation Mode (1, 2, or 3) 1 <CR> 
New Mode = TMS32020 


Command: 


3-89 


SK 


Description 


Example 


3-90. 


Modify/Inspect Stack 


SK provides the means to modify and/or inspect all four levels of the stack. 
The stack is always displayed in sequential, top-to-bottom form. 


As each level is shown, changes can be made at that level. If a change is 
desired, a hexadecimal value of up to three (TMS320C10) or four 
(TMS32020, TMS320C25) characters may be entered. If no change is 
desired, enter a carriage return to proceed to the next level. 


To terminate the process before reaching the bottom of the stack, enter a 
hyphen (-). The simulator then returns to the MH menu. SK is listed in the 
RH menu. 


Note that SK changes the stack contents but does not alter the stack poin- 
ter. 


This display appears for the TMS320C10. 


ENTER COMMAND (HELP=<CR>): 
SK <CR> 


TOP OF STACK - 0 

>548 

ENTER NEW VALUE (IN HEX).OR "-" TO TERMINATE 
<CR> 


TOP OF STACK - 1 

>52F 

ENTER NEW VALUE (IN HEX) OR "-" TO TERMINATE 
Q <CR> 


TOP OF STACK - 2 

>548 

ENTER NEW VALUE (IN HEX) OR "-" TO TERMINATE 
= <CRO 


ENTER COMMAND (HELP=<CR>): 
This example does not change the top of the stack but zeros the second 


level (location one) of the stack. At the third level, a hyphen (-) terminates 
the command. 


Modify/Inspect Stack 


Example 


This display appears for the TMS32020/C25. 


COMMAND: SK <CR> 


STACK 
STACK 
STACK 
STACK 
STACK 
STACK 
STACK 
STACK 


SOO BWNOEFHO 


Enter Stack level or 
Stack value (in Hex): 
Enter Stack level or 


COMMAND: 


OODO0O000 


"—" to terminate 
Q <CR> 


"—~" to terminate 


es) 


SK 


Select Output Port File 


sO 


Description 


Example 7 


Example 2 
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SO associates an existing file with an output port. The associated output 
files can be displayed using the LF command on the TMS320C10 and the 
LO command on the TMS32020 and TMS320C25. The SO command is 
listed in the IOH menu. 


If a file is already associated with the specified port, the new file overrides 
the old file. Therefore, execution of an OUT instruction produces a write 


_ to the file associated with the appropriate port. The output defaults to the 


screen if no file is associated with the appropriate port. 
This display appears for the TMS320C10. 


ENTER COMMAND (HELP=<CR>) : 
SO <CR> 


ENTER THE OUTPUT PORT (0,...,7) 
5 <CR> 

ENTER FILE NAME FOR OUTPUT 
NAME .OUT <CR> 


ENTER COMMAND (HELP=<CR>): 
This display appears for the TMS32020 and TMS320C25. 


ENTER COMMAND (HELP=<CR>): 
SO <CR> 


ENTER THE OUTPUT PORT (0,...,15) 
5 <CR> 

ENTER FILE NAME FOR OUTPUT 
NAME.OUT <CR> 


ENTER COMMAND (HELP=<CR>): 


These examples associate the file NAME.OUT with output port 5. Now 
when an OUT instruction is directed to port 5, the data will be written to 
the file NAME.OUT. 


Store RAM Data 
to External File (TMS320C25) SRAM 


Description SRAM stores RAM data to an external file, making RAM initialization easier. 
The SRAM command prompts for a filename, the starting address, and the 
ending address of the data memory to be stored in a file. The default ad- 
dress address range is 0-65535. 


You may create a file using the SRAM command, which stores the RAM 
data to an external file. The LRAM command loads the stored file into 
simulator memory. Note that the file you load using the LRAM command 
must have the same format as the file created using the SRAM command. 
SRAM is in the UTLH menu. 


Example 1 COMMAND: SRAM <CR> 
ENTER FILE NAME: TEXT1.TXT <CR> 


Enter START address (in Hex): 
Enter END address (in Hex) 


Irjo 


COMMAND: 


Below is the format of the file created by SRAM. 


PSEG DATA 
DEF XXXX 
XXXX EQU $ 
DATA 19728 
DATA 19731 
DATA 19733 
DATA 19747 
DATA 19781 
DATA 19781 
DATA 19796 
PEND 
[ECB] 
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SS 


Single Step 


Description 


Example 
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SS executes a program one instruction at a time, suspending execution after 
each instruction. SS is located in the TMS320C10 Simulator DM menu. 
For the TMS32020/C25 Simulator, SS is in the EH menu. 


The ST command is automatically implemented after each program in- 
struction is executed, displaying the new status of the registers. To con- 
tinue the single-step execution, enter a carriage return. To halt the 
execution, enter a hyphen (-). 


ENTER COMMAND (HELP=<CR>): 
SS <CR> 


After each step is completed, the simulator displays the current status of the 
registers (see the ST command for sample displays). 


ENTER <CR> TO CONTINUE 
"—" TO TERMINATE 
=. “CR? 


ENTER COMMAND (HELP=<CR>): 


This example returns to the main simulator prompt after it executes one in- 
struction. The hyphen (-) terminates the single-step session. 


Display/Update Register Status ST 


Description ST simultaneously displays (in hexadecimal) the contents of the program 
counter, the opcode and mnemonic name of the current instruction, the 
previous value of the program counter, and all four stack location contents. 
On the TMS32020/C25, ST updates the already displayed fields. 


ST displays the following registers and their values on the TMS320C10: 


Auxiliary Register Pointer (ARP) 
Auxiliary Registers (ARO, AR1) 
T Register (TREG) 

P Register (PREG) 

Accumulator (ACC) 

Clock Counter (CLK) 

Data Memory Page Pointer (DP) 
|/O Branch Control Pin (BIO) 
Interrupt Flag Register (INTF) 
Interrupt Mode Register (INTM) 
Overflow Flag Register (OV) 
Overflow Mode Register (OVM) 
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ST 
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Display/Update Register Status 


On the TMS32020/C25, the ST command updates the following registers 
and their values: 


Program counter (PC) 

Instruction executed in previous cycle (-1) 
Instruction executed 2 cycles past (-2) 
Instruction executed 3 cycles past (-3) 

Auxiliary registers (ARO-AR7) 

Stack Values (SKO-SK7) 

Interrupt flag register (IFR) 

Interrupt mask register (IMR) 

Ram(0) serial port data receive register (DRR) 
Ram(1) serial port data transmit register 

RAM(2) timer register (TIM) 

Period register value (PDD | 

Global memory allocation register value (GREG) © 
The T-register value (TREG) 

The P-register value (PREG) 

Accumulator (ACC) 

Chip operation in ee ean er mpUners mode (MP/MC) 
Status Register 0 value (STO) 

Auxiliary register buffer value (ARB) 


Carry Flag (CRY) 


Frame sychronized mode bit (FSM) 
Overflow mode flag (OVM) 

Test/Control flag (TC) 

Output port (OUTP) 

Repeat instruction counter (RPTC) 

Status register 1 value (ST1) 

Auxiliary register buffer pointer value (ARP) — 
Data memory page pointer (DP) 

Interrupt mode (INTM) |. 

Product register shift mode (PM) 

Transmit mode bit (TXM) 

Clock counter (CLK) 

|/O branch control value (BIO) 

On chip Ram BO configuration (CNFD/CNFP) 
Format mode bit (FQ) 

Overflow mode flag (OV) 

Sign extension mode flag (SXM) 

Status of external flag output pin (XF) 
Prompt for command input (COMMAND) 


Display/Update Register Status 


Example 


Example 


PC 
af 
=2 
a: 


: 0000 
:0000 
>0000 
:0000 


ARO: 
ARI: 
AR2: 
AR3: 
AR4: 
AR5: 
AR6: 
AR?7?: 


This example shows a TMS320C10 display. 


ENTER COMMAND (HELP=<CR>) : 


ST <SCR> 


>>PC= 7 


INTEGER 


HEX 


>>STK= 


ARP 


2 


ST 
OPCODE= O ADD PREVIOUS PC= 6 
ARO ARI TREG PREG ACC CLK 
16 0 256 5 24 8 
10 0 LOO | 15 8 
0 DP = O INTF= O OV = 0 
BIO= 1 INTM= 1 OVM= O 


ENTER COMMAND (HELP=<CR>): 


This example shows a TMS32020/C25 display. 


COMMAND: ST <CR> 


ADD 
ADD 
ADD 
ADD 


0000 
0000 
0000 
0000 
0000 
0000 
0000 
0000 


>0200 
>0200 
>0200 
>0200 


COMMAND: 


STACK 
SKO: OOOO 
SK1: 0000 
SK2: 0000 
SK3: 0000 
SK4: 0000 
SK5: 0000 
SkK6o: 0000 
SK7: OOO00 


C25 MP 


IFR :000000 
IMR :000000 
MMRS 
DRR :0000 
DXR :0000 
TIM :FFFF 
PRD :FFFF 
GREG: 0000 


TREG: 
PREG: 
ACC 


STO:0604 
ARB: 
CRY: 
FSM: 
OVM: 
TC 
OUTP: 0000 
RPTC: 0 


OrRrOO 


0000 
OOO000000 
OO0000000 


ST1l :O7FO BIO: 


ARP :0 
DP :04 
INTM: 1 
PM Ht 
TXM :0O 

CLK 


The ST command has updated the simulator’s machine-state display fields. 
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STH 


_Modify/iInspect Status Registers/Pins 
Help Menu (TMS32020/C25) 


Description STH displays the commands used to display/modify parameters that appear 


in the status register. 
‘DM menu. 


STH is located in the TMS32020 and TMS320C25 


Example 1 _ This display appears for the TMS32020/C25. 


COMMAND: STH <CR> 


MODIFY/INSPECT STATUS REGISTER COMMANDS ARE: 


ARB : AUX reg pointer buff ARP 
CNF : RAM CNF bit DP 
FO : Format bit INTM : 
OV Ovflw flg reg OVM : 
PM Product shift mode SXM 
pie Test/Control flg bit TXM 
XF XF pin CY 
HM Hold mode bit) | FSM 
COMMAND: 


: AUX Reg Pointer 
: Data memory page Pointer 


INTerrupt flag Mask reg 
Ovflw Mode reg 

Sign extension mode bit 
Transmit mode bit 

Carry bit 

Frame sync mode bit 


Any command may be entered after the COMMAND: prompt. 
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Save Trace Buffer STR 


Description 


Example 


Example 


STR saves the contents of the trace buffer in a file for retrieval after the 
simulator session is ended. STR its located in the TMS320C10 Simulator 
DM menu and in the TMS32020/C25 Simulator TH menu. 


Entering the STR command produces one of the two following series of 
prompts, as shown in the examples. 


The display in the trace buffer file is nonexistent. 


ENTER COMMAND (HELP=<CR>): 
STR <CR> 


ENTER TRACE BUFFER FILE NAME - NONE EXISTS 
TRACE .DAT <CR> 


ENTER COMMAND ( (HELP=<CR>) : 


On a VAX/VMS system, if no file name is entered, the TMS320C10 Simu- 
lator uses the default file FORO88.DAT. All other simulators will not create 
a file at all. 

This display is shown if STR has already been used in the present session. 


ENTER COMMAND ((HELP=<CR>): 
STR <CR> 


TRACE BUFFER FILE ALREADY EXISTS | 
ENTER NEW NAME 
TRACE1.DAT <CR> 


ENTER COMMAND (HELP=<CR>) : 


If a new file name is not entered, the current trace buffer will be appended 
to the contents of the old file (the old contents will not be overwritten). 
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SW 


Description 


Example 1 
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Switch from Screen to File (TMS32020/C25) 


The SW command saves the simulation state in a disk file by switching the 
screen output device from the terminal to the specified file. Once the output 
is switched to the file, the results of the following commands are saved in 
a file: 7 


RAM 
RAMH 
RAMI 
ROM 
ROMH 
ROMI 
PUSH 
POP 
VIEW 


The SW command prompts for a log filename if one has not yet been set. 
Entering the SW command a second time causes future displays to be out- 
put on a standard output device. Entering the SW command a third time 
toggles the mode so that the output displays from the above commands are 
appended to the log file. 


COMMAND: SW <CR> 


ENTER LOG FILE NAME : TEXT.TXT 
Switched to the log file 


COMMAND: 


Modify/Inspect Sign-Extension 
Mode Bit (TMS32020/C25) SXM 


Description _SXM allows you to inspect and change the sign-extension mode bit value. 
SXM is listed in the TMS32020 and TMS320C25 Simulator STH menu. 


The SXM bit values are listed in Table 3-10. 


Table 3-10. Sign-Extension Mode Bit Values 


fxm] S~™~“—sSCsRRSSCSC~*S 
ee Suppresses sign extension. 
Sign extension as data is passed into the accumulator. 


Example ENTER COMMAND (HELP=<CR>): 
SXM <CR> 
PRESENT VALUE OF SIGN EXTENSION MODE BIT 
O 
ENTER NEW VALUE (0 OR 1) 
1 <CR> 


ENTER COMMAND (HELP=<CR>): 


> AFA 


Modify/Inspect T Register 


Description 


Example 
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The T command displays and allows modification of the T register. T is 
located in the RH menu. | 


ENTER COMMAND (HELP=<CR>): 


T <CR> 

PRESENT VALUE OF THE T REGISTER 
> F89 

ENTER NEW VALUE (IN HEX) 

0 <CR> 


ENTER COMMAND (HELP=<CR>): 


Check the status of the T register with the ST command. 


Modify/Inspect Test/Control Flag Bit (TMS32020/C25) TC 


Description 


Example 


TC displays and allows modification of the test/control flag bit of the status | 
register. TC is listed in the TMS32020 and TMS320C25 Simulator STH 
menu. 


ENTER COMMAND (HELP=<CR>): 
To <CR> 


PRESENT VALUE OF TEST/CONTROL FLAG BIT 
0 | 


ENTER NEW VALUE (0 OR 1) 
1 <CR> 


ENTER COMMAND (HELP=<CR>): 


“ £ARN. 


TH 


Description 


Example 
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Trace Help Menu (TMS320C25) 


TH displays commands that control notation, and display and update the 
status registers. TH is located in the TMS320C25 DM menu. 


This display appears for the TMS320C25. 
COMMAND: TH <CR> 


STR >: save the trace buffer 


TR : toggle trace mode (on or off) 
JF : select journal file | 
DT : display the trace buffer 
Z : zero clock counter 
COMMAND: 


Specify Clock Tics until Next Interrupt (TMS320C10) TIC 


Description 


Example 


TIC generates interrupts every x number of clock tics. 


After the simulator prompts for the interrupt interval, the simulator prompts 
for the interrupt counter. Both values are entered as hexadecimal numbers. 
In the following example, an interrupt is generated every >1000 clock tics 
until five interrupts have been generated. The simulator then proceeds 
without interrupts. The TIC command is listed in the TMS320C10 DM 
menu. 


ENTER COMMAND (HELP=<CR>): 
TIC <CR> 


ENTER THE NUMBER OF CLOCK TICS TILL INTERRUPT 

1000 <CR> 

ENTER THE NUMBER OF TIMES TO REPEAT THE INTERRUPT 
CYCLE 

5 <CR> 


ENTER COMMAND (HELP=<CR>): 


Note: TICO-TIC2 commands are used for the TMS32020/C25 simu- 


lator. 
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TICO-TIC2 


Description 


Example 
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Specify Clock Tics until 
Interrupt (TMS32020/C25) 


The TICO, TIC1, and TIC2 commands allow interrupts to be generated every 
x number of clock tics. The TICO-TIC2 command is listed in the TMS32020 
and TMS320C25 Simulator TICH menu. 


After the simulator prompts for the interrupt interval, the simulator prompts 
for the interrupt counter. Both values are-entered as decimal numbers. In 
the following example, interrupt #0 is generated every 1000 clock tics until 


_ five interrupts have been generated. ‘The simulator then proceeds without 
— interrupts... | 


ENTER COMMAND (HELP= <CR>) : 


é TELCO: SCR 


ENTER THE NUMBER OF CLOCK TICS TILL INTERRUPT #0 
1000 <CR> 

ENTER THE NUMBER OF TIMES TO REPEAT THE INTERRUPT 
CYCLE 

5 <CR> 


ENTER COMMAND (HELP=<CR>) : 


Each TIC command (TICO, TIC1, and TIC2) produces the same series of 
prompts. 


Interrupt/Timing Help Menu (TMS32020/C25) TICH 


Description — TICH lists commands that are available to display/modify timing and inter- 
rupt-related items. TICH is located in the TMS32020 and TMS320C25 
Simulator DM menu. 


Example This display appears for the TMS32020/C25. 


COMMAND: TICH <CR> 


INTERRUPT/TIMING COMMANDS ARE: 


DWAIT : # of wait cycles for Ext-Data memory response 
IOWAIT : # of wait cycles for Ext-I/O memory response 
PWAIT : # of wait cycles for Ext-program memory 
: response 
TICO : number of clock tics till interrupt #0 
TICL : number of clock tics till interrupt #1 
TIC2 : number of clock tics till interrupt #2 
ZTIC : disables the tic commands 
XINTM : modify XINTM bit 
RINTM : modify RINTM bit 
COMMAND: 


Any command may be submitted after the COMMAND prompt. 


oo A rrms 


TINT 
Description 


Example 
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Modify/inspect Timer 
Interrupt Flag (TMS32020/C25) 


_ TINT displays and allows modification of the value of the timer interrupt 


flag in the interrupt flag register. TINT is listed in the TMS32020 and 
TMS320C25 Simulator RH menu. 


ENTER COMMAND (HELP=<CR>): 


TINT <CR> 
PRESENT VALUE OF TINT 
0 

ENTER NEW VALUE (0,1) 
1 <CR> 


ENTER COMMAND (HELP=<CR>): 


Modify/Inspect Timer | 
Interrupt Mask (TMS32020/C25) TINTM 


Description _TINTM displays and allows modification of the value of the timer-interrupt 
mask in the interrupt mask register. TINTM is listed in the TMS32020 and 
the TMS320C25 Simulator RH menu. : 


Example ENTER COMMAND (HELP=<CR>) : 
TINTM <CR> 


PRESENT VALUE OF TINTM 
e) 


ENTER NEW VALUE (0,1) 
1 <CR> 


ENTER COMMAND (HELP=<CR>): 
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TR 


Toggle Trace Mode 


Description 


Example 
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TR toggles the trace mode on or off. The trace is a circular buffer, 256 
samples long, that traces the auxiliary registers, accumulator, and the pro- 


gram counter. With the trace on, the last 256 states of the simulation can 


be displayed. The default for the trace is off. TR is located in the 
TMS320C10 Simulator DM menu. In the TMS32020/C25 Simulator, TR 
is in the TH menu. 


The DT command displays the trace buffer contents; the STR command 
saves the trace buffer. | 


Note that when the trace wraps, the previous entries are overwritten; the 
trace buffer always contains the /ast 256 entries. If execution is stopped 
and restarted (when the next R, C or SS command is executed), the trace 
buffer is reinitialized, the new entries are not appended to the previous en- 
tries. 


ENTER COMMAND (HELP=<CR>) : 
TR <CR> 
TRACE MODE IS ON 


ENTER COMMAND (HELP=<CR>) : 


The trace mode is toggled from off to on in this example. 


Modify/Inspect Transmit 
Mode Bit (TMS32020/C25) TXM 


Description TXM displays and allows modification of the transmit mode bit. TXM is 
listed in the TMS32020 and TMS320C25 Simulator STH menu. 


Example ENTER COMMAND (HELP=<CR>): 
TXM <CR> 


PRESENT VALUE OF TRANSMIT MODE BIT 
e) 


ENTER NEW VALUE (0 OR 1) 
1 <CR> a 


ENTER COMMAND (HELP=<CR>) : 
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UTLH 


Description 


Example 
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Utilities Help Menu (TMS32020/C25) | 


UTLH displays commands that control notation, and display and update the 
status registers. UTLH is located in the TMS320C25 DM menu. 


This display appears for the TMS320C25. © 


COMMAND: 


SW 
SRAM 
LRAM 
DC 
PUSH 
POP 
VIEW 
SGN 


COMMAND : 


UTLH <CR> 


SWitch output toggle [SCREEN/FILE] 
Store Ram data to text file | 
Load Ram data from text file 
Display Control | 

Save registers on save stack 
Restore registers from save stack 
Display the save stack 

save wave generator on RAM 


Modify/Inspect XF Pin (TMS32020/C25) XF 


Description  XF allows you to modify and inspect the XF pin. XF is listed in the 
TMS32020 and TMS320C25 Simulator STH menu. 


Example ENTER COMMAND (HELP=<CR>): 
XF <CR> 
PRESENT VALUE OF XF PIN 
ug 
ENTER NEW VALUE (0 OR 1) 
OQ <CR> 


ENTER COMMAND (HELP=<CR>) : 
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XINTM 


Description. 


‘Example — 


_Modify/Inspect XINTM Bit (TMS320C25) 


The XINTM command allows you to inspect and change the XINTM bit in 
an the interrupt mask register. XINTM is in the TICH menu. 


“COMMAND: XINTM <CR>- 


Present value of XINTM 20 


_ Enter new value (0, 1) > i <CR> 
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“COMMAND : oS 


Assign XMT Channel to file (TMS320C25) XMT 


Description 


Example 


The XMT command assigns a serial port (XMT) channel to a specified file. 
The simulator prompts for the number of clock tics per sample (which is 
per word or per byte, depending on the mode in effect) read from the input 
file. The data is produced in hexadecimal ASCII format. XMT is in the l|OH 
menu. 


If the channel to the ports is not specified, no interrupt will occur in the 
simulator When no interrupt occurs, the simulation speed accelerates. If the 
channel to the ports is specified, the simulator displays the serial port reg- 
ister value in greater brightness than before. When the input stream data 
is exhausted, the file is automatically closed. The constant “FFFF” appears 
in normal brightness. 


COMMAND: XMT <CR> 


Enter XMT data file name: TEXT2.TXT 
Min XMT IRT cycle (x100) 16 when FO=1 
Min XMT IRT cycle (x100) 32 when FO=0 
Enter XMT IRT cycle (x100 nsec): 32 


serial port XMT channel assigned. 


COMMAND : 
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XMTC Close the (XMT) Channel File (TMS320C25) 


Description The XMTC command closes the XMT channel file. XMTC is in the IOH 
menu. 


Example COMMAND: XMTC <CR> 


serial port XMT channel closed. 


COMMAND: 
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Zero Clock Counter | Z 


Description  Z clears the clock counter. The CC command displays the status of the 
clock counter (the number of clock cycles that have occurred since the 
simulator started). Z is listed in the TMS320C10 Simulator DM menu and 
in the TMS32020/C25 Simulator TH menu. 


Example ENTER COMMAND (HELP=<CR>): 
Z <CR> 


CLOCK COUNTER HAS BEEN ZEROED 


ENTER COMMAND (HELP=<CR>): 


Use the ST command to verify the clock counter status. 
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ZRAM Set RAM Contents to Zero (TMS32020/C25) 


Description | ZRAM sets RAM contents (addresses 6 through 65535) to zero. ZRAM is 
—_ in the MH menu. 


Example — COMMAND: ZRAM <CR> 
RAM DATA CLEARED 
COMMAND : 
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Disable TIC Commands ZTIC 


Description  ZTIC disables interrupts set by the TIC command. The ZTIC command is 
in the TMS320C10 Simulator DM menu and in the TMS32020 and 
TMS320C25 Simulator TICH menu. 

Example This example is for the TMS320C10. 


ENTER COMMAND (HELP=<CR>): 
ZTIC <CR> 


THE TIC COMMAND HAS BEEN DISABLED 
ENTER COMMAND (HELP=<CR>): 
Example This example is for the TMS32020 and TMS320C25. 


ENTER COMMAND (HELP=<CR>): 
ZTLC.KCR> 


TICO, TIC1, AND TIC2 COMMANDS HAVE BEEN DISABLED 


ENTER COMMAND (HELP=<CR>): 
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Simulator Commands - I/O Simulation 


3.4 1/O Simulation 


All first generation TMS320C10 digital signal processors contain the same 
internal CPU and can benefit from using a common software simulator. In this 
environment, data files can be used to simulate the I/O interface in a target 
system. The file should list one data value per line, written at the far left mar- 


gin. i 


The TMS320C17 and TMS320E17 each have two additional I/O peripheral 
circuits: a dual-channel serial port and a coprocessor mode. These ports allow 
the device to interface directly to two combo codecs and a microcomputer. 
Although the software simulator does not directly implement these hardware 
ports, they can be simulated as parallel 1/O. Here data is accessed using the 
parallel 1/O port instructions IN and OUT. The sections below discuss simu- 
lation techniques for these peripheral interfaces. : 


3.4.1 Serial Port 
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The dual-channel serial port on the TMS320C17 device provides all of the 
necessary clocking and framing signals to directly interface to two combo co- 
decs. The processor interprets all data as parallel 13-bit two’s complement 
numbers. Therefore, the user must set up his input file with the serial port data 
represented in two’s complement format rather than in its 8-bit PCM form. 


If the TMS320C17 serial ports are configured to be interrupt driven, then the 
interrupt traps can be initiated via the simulator’s interrupt counter. The count 
value loaded into the simulator is a function of the sample rate of the proces- 
sor. The relationship is as follows: 


COUNT = (CLKIN/4) / SAMPLE 


where COUNT = count value used by the simulator 
CLKIN = processor input frequency 
SAMPLE = codec’s sample rate 


The following example illustrates how the number of instruction cycles is cal- 
culated before an interface interrupt occurs: 


Assume CLKIN 


= 18.432 MHz 
SAMPLE = 9.6 kHz 
then COUNT = (18432/4) / 9.6 = 480 instruction cy- 


cles. 


No synchronization is required if the serial port is polled rather than interrupt 
driven. 
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3.4.2 Coprocessor Port 


The coprocessor port on the TMS320C17 device facilitates the interface to 
other microcomputers or microprocessors in the system. In a multiprocessing 
environment, the TMS320C17 can act as either master or slave. No synchro- 
nization is required when simulating the TMS320C17 as master. In a slave 
configuration, the synchronization can be handled using the cycle count 
method described above, or the user can “break” the executing code by the 
following keystrokes: 


@ Striking <CNTRL-C> on VAX/VMS systems. 


®@ Striking any key on MS/PC-DOS systems running the TMS320C10 
simulator. 


When interfacing to 8-bit microcomputers in hardware, the TMS320C17 reads 
the eight LSBs on the data lines. In software, the simulator reads all data as 
16-bit values. The data file can contain 4, 8 or 16-bit values. 
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Simulator Commands - 1/O Simulation 
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Section 4 


Sample Debugging Sessions 


The following debugging sessions are presented to give the reader an under- 
standing of how to find and correct errors in programs. There are two de- 
bugging sessions, one for the TMS320C10 simulator and one for the 
~TMS32020 and TMS320C25 simulators. 


A program must be assembled and linked using the TMS320C10, TMS32020, 
or TMS320C25 Macro Assembler/Link Editor programs before it can be tested 
and debugged. After a TMS320C10, TMS32020, or TMS320C25 object file 
has been developed by the assembler, it is necessary to test the program on 
the simulator in order to verify that it executes correctly. 


The program to be debugged is a 5 tap FIR filter as presented in the book, 
Digital Signal Processing Applications with the TMS320 Family. The FIR filter 
is simply a finite length weighted sum of the present and previous inputs to 
the filter. The equation of the filter is written as 


x(n-4)h(4) + x(n-3)h(3) + x(n-2)h(2) + x(n-1)h(1) + x(n)h(O) = y(n) 


Figure 4-1 gives an example of a length-5 direct-form FIR filter. 


x(n) 


Figure 4-1. Length-5 Direct-Form FIR Filter 


These debugging sessions follow this sequence of steps: 
1) Test the program on the simulator for accuracy. 

2) If an error is indicated, locate the error. 

3) Correct the error. 

4) Test the revised program for accuracy. 


These debugging examples can be found on the following pages. 


Section Page 
4.1 TMS320C10 Debugging Example 2.0... eeeeeeeeeeeeeeeanneneees eee 4-2 
4.2 TMS32020/C25 Debugging Example ......... Socacuibeta cep amasm cies Soe etganianh 4-15 
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4.1 TMS320C10 Debugging Example 


The TMS320C10 program in this debugging example attempts to perform a 
simple 5 tap FIR filter of the equation 
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x(n-4)h(4) + x(n-3)h(3) + x(n-2)h(2) + x(n-1)h(1) te x(n)h(0) = y(n) 


However, there is a “bug” in the program. The simulator will be used to detect 
the “bug” and correct the code. The sequence of steps in a debugging session 
is followed for this TMS320C10 example. 


In the program shown in Figure 4-2, the TMS$320C10 will prompt the user for 
an input. The value 6 should be entered, and it will be stored at location XNO. 
A breakpoint will be set to determine the output of the first pass of the filter. 
According to the program the first data sample, 6, should be multiplied by the 
first filter coefficient, 3, giving an output of 12. Although it may be obvious 
where the “bug” is, the simulator will be used to discover it and correct the 


program. 


AORG 
EQU 


10 ; LOAD PROGRAM STARTING AT LOCATION 
50 ;OUTPUT ADDRESS. 

51 ;FIRST INPUT ADDRESSES. 

yo ;LAST INPUT ADDRESSES. 

0 


XNO,PAO ;GET NEW INPUT VALUE XN FROM PORT 


ARO,XNO ;STORE LOCATION AT XNO. 
;ZERO ACCUMULATOR. 


ae >3x(n) ;h(0)=2. 

2 

waa 2-4x(n-1);h(1)=3. 

3 

Ret >3x(n-2) ;h(2)=4. 

4 

ide e2x (ns) (3) 3 

3 

seg °>5x(n-4) ;h(4)=2. 

2 
sADD RESULT OF LAST MULTIPLY TO 
; ACCUMULATOR. 

YN *STORE RESULT IN YN. 


YN,PA1L ;OUTPUT THE RESPONSE TO PAI. 
NXTIN ;GET THE NEXT INPUT VALUE. 


Figure 4-2. TMS320C10 Test Program 
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1) 


Test the program on the simulator for accuracy. 


Figure 4-3, page 4-4 illustrates the following procedure used to test the 
program. 


8 Begin simulator execution. 


® Choose either the microprocessor or microcomputer mode of op- 
eration. 


Load the program. 

Name the file in which the object file is stored. 
Enter the breakpoints. 

Run the program; enter <CR>. 

Enter the input values. 

View the processor status on the screen. 

Note the error (if indicated). 


To begin testing the program, the simulator begins by entering the 
proper command (see Section 2 for execution verification). The simu- 
lator next prompts that either O or 1 be entered to place the simulator in 
the microprocessor or microcomputer mode, respectively. The micro- 
processor mode is selected, so 0 is entered. The default also places the 
simulator in microprocessor mode. 


The L (load) command is next entered to load the program into the 
simulator. The simulator prompts for the file name in which the object 
file is stored. BUG10.MPO is entered since this is the file name for this 
program. The simulator executes all of the instructions it encounters 
until it is halted by either a <CR>, an interrupt, a branch to self, a set 
breakpoint, or an error. Since a breakpoint will be set at the OUT in- 
struction, the simulator will stop further instruction execution. 


VVhen the simulator encounters a breakpoint, it displays the processor 
s.iatus. At this time, it can be seen if the program has executed as de- 
sired. This program did not execute correctly since the output is 84 in- 
stead of 12. At this point a RAMH command should be entered to check 
the data RAM. Since the value 6 is in all input value locations, we can 
conclude that the first input sample is being incorrectly multiplied by all 
filter coefficients. 
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SIMULATION OF THE TMS320C10 
VERSION # 2.0 


O - MICROPROCESSOR MODE (ADDR 0-1535, OFF CHIP) 
1 - MICROCOMPUTER MODE (ADDR 0-1535, ON’ CHIP) 


ENTER VALUE TO SELECT MODE OF OPERATION 


0. -<CR> 


YOU ARE IN THE MICROPROCESSOR MODE (ADDR 0-1535, OFF CHIP) 


ENTER COMMAND (HELP=<CR>): 
L <CR> 


ENTER A NEW OBJECT FILE 
BUG1O.MPO <CR> | 
* * * * LOADING PROGRAM "NOSIDT " * * * * 


ENTER COMMAND. (HELP=<CR>): 
BIAQO <CR> 


- BREAK ON INSTRUCTION ACQUISITION 


ENTER THE ADDRESS (IN HEX) 


1A <CR> 
-ENTER COMMAND (HELP=<CR>): 
RUN <CR> | 
->>PC= BB SCOPCODE=4033.0- INS PREVIOUS PC= 
eae ARP ARO ARI TREG PREG ACC 
INTEGER 0 0 0 0 0 0 
HEX 0 0 0 0 0 0 
>>STK= O 0 0 8) DP = 0 INTF= 0 OV =0 
BIO= 1 INTM= 0 OVM= 0 
ENTER INPUT VALUE (IN HEX) OR "-" TO RETURN TO MAIN 
6 <CR> 
* * * OUTPUT VALUE (IN HEX) IS 54 
>>PC= 1A  OPCODE=4932 our PREVIOUS PC= 
| ARP ARO AR1L ~=«s«TREG PREG ACC 
INTEGER 0 56 0 é 12 84 
HEX 0 38 0 6 Oc 54 


>>STK= 0 0 0 0 DP = 0 INTF= 0 OV = 0 
BIO= 1 INTM= 0 OVM= 0 
>>> INSTRUCTION AQUISITION BREAK POINT #41 <<< 


CLK 


19 


CLK 
19 
13 


Figure 4-3. Error Revealed in Tested TMS320C10 Program 
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ENTER COMMAND (HELP=<CR>): 


RAMH <CR> 


0 1 2 3 4 5 6 7 
8 9 A B C D E F 
O 0 O 0 @) 0 6) 0 
0 0 O O 0 0 0 O 
0 O 0 O O 0 0 0 
O O O O 0 O O O 
0 O O 0 0 0 0 O 
0 0 9) 0 0 0 0 O 
O 0 5A 6 6 6 6 6 
0 6) 0 0 O 0 0 0 
e) 0 0 O 0 O O O 
0 @) 0 O O @) 0) 0 
O 0 0 O O 0 0 O 
0 0 0 0 0 0 0 0 
0 0 O O O 0) O 0 
0 0 6) 0 0 0 0 @) 
O 0 O 6) O O @) 0 
0 0 O 0 Q 0 O O 
0 @) 0 0 0 0 0 0 
0 0 O 0 0 0 0 e) 


Figure 4-3. Error Revealed in Tested TMS320C10 Program (Concluded) 


2) 


Locate the error. 


Figure 4-4, pages 4-6 to 4-8, illustrates the following procedure. 


Clear the P register. 
Clear the T register. 
Reset the simulator. 
Set an additional breakpoint. 


Single-step through part of the program, viewing the results of 
each instruction. 


When an error ts located, inspect the memory locations for that 
instruction. 


Locate the error in memory. 


Since the program did not result with the desired number for an output, 
the next step is to locate the error. To reset the program the P register 
and T register must be cleared. This is done by entering P <CR>. After 
being prompted for a new value, enter 0. Do the same for the T register. 
Next, the simulator is reset using the RS. command, and an additional 
breakpoint ts added at the ZAC instruction (address D). From this point 
the program will be single stepped through to determine the cause of the 


error. 


In this pass the value 5 should be entered for an input value so 


that it can be distinguished form the previous input value. 
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4-6 


ENTER COMMAND (HELP=<CR>) : 
P <CR> 


PRESENT VALUE OF THE P REGISTER 
> .1E | 

ENTER NEW VALUE (IN HEX) 

OQ <CR> 


ENTER COMMAND (HELP=<CR>) : 
T <CR> 


PRESENT VALUE OF THE T REGISTER 
> 6 

ENTER NEW VALUE (IN HEX) 

Q <CR> 


ENTER COMMAND (HELP=<CR>) : 
RS <CR> 


ENTER COMMAND (HELP=<CR>): 
BIAQ <CR> 


BREAK ON INSTRUCTION ACQUISITION 
ENTER THE ADDRESS (IN HEX) 


D <CR> 
ENTER COMMAND (HELP=<CR>): 
R <CR> 
>>PC= B OPCODE=4033 IN PREVIOUS PC= A 
ARP ARO ARI TREG PREG ACC CLK 
INTEGER 0 54 0 0 0 54 29 
HEX 0 36 0 0 0 36 1D 
>>STK= 0 O 0 0 DP = 0 INTF=0 ov = 0 
BIO= 1 INTM= OVM= 0 
ENTER INPUT VALUE (IN HEX) OR "-" TO RETURN TO MAIN 
5 <CR> 
>>PC= D OPCODE=7F89 ZAC PREVIOUS PC= Cc 
ARP ARO ARI TREG PREG Acc CLK 
INTEGER 0 51 0 0 0 0 34 
HEX 0 33 0 0 0 0 22 
>>STK= 0 O 0 0 DP =0 INTF= ov = 0 
BIO= 1 INTM= OVM= 0 
>>> INSTRUCTION ACQUISITION BREAK POINT #2 <<< 


Figure 4-4. Single-Stepping Through the TMS320C10 Program 


Next the data memory is checked to insure that the first data sample has 
been written into the correct data RAM location. Using the RAMH 
command we see that the 5 was indeed written into location 33 (hex). 
Single stepping is continued. The next two instructions, LTD and MPYK 
appear correct. However, the next LTD is incorrect because a 6, not a 5, 


should be loaded into the T register. 
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ENTER COMMAND (HELP=<CR>): 


RAMH <CR> 
0 1 2 3 4 5 6 7 
8 9 A B c D E F 
0 0 0 ©) 0 0 0 0 0 
8 0 0 0 0 6 0 O C 
10 0 0 0 0 0 0 0 0 
18 0 0 0 0 0 0 0 0 
20 0 0 0 0 0 0 0 0 
28 0 0 ) 0 0 0 0 0 
30 0 0 5A 5 6 6 6 6 
38 0 0 0 0 0 0 0 6 
40 O 0 0 0 0 O 0 © 
48 0 0 0 0 0 0 O 0 
50 0 0 0 0 0 0 0 0 
58 0 0 0 0 O 0 0 0 
60 0 0 0 0 0 0 0 0 
68 0 0 0 0 0 0 0 0 
70 0 0 0 0 0 0 0 © 
78 0 0 ©) 0 0 0 Ov 0 
80 0 0 0 © © 0 0 0 
88 0 0 @) 0 0 0 © 0 
30 0 0 O 0 0 0 © 0 
ENTER COMMAND (HELP=<CR>): 
SS <CR> 
>>PC= E OPCODE=6BA8 LTD PREVIOUS PC= D 
ARP ARO AR1 TREG PREG ACC CLK 
INTEGER 0 52 0 5 0 0 35 
HEX 0 34 ) 5 0 0 23 
>>STK= OO 0 0 0 DP = 0 INTF= 0 OV = 0 
BIO= 1 INTM= 1 OVM= 0 
ENTER <CR> TO CONTINUE 
"-" TO RETURN TO MAIN 
<CR> 
>>PC= F OPCODE=8003 MPYK PREVIOUS PC= E 
ARP ARO AR1 TREG PREG ACC CLK 
INTEGER 0 52 0 5 10 © 36 
HEX 0 34 0 5 A 0 24 
>>STK= 0 0 0 0 DP = 0 INTF= 0 OV = 0 


BIO= 1 INTM= 1 OVM= O 


ENTER <CR> TO CONTINUE 
"—" TO RETURN TO MAIN 


Figure 4-4. Single-Stepping Through the TMS320C10 Program (Continued) 


Sample Debugging Sessions - TMS320C10 Debugging Example 


<CR> 
_>>PC= 10 OPCODE=6BA8 LTD ss PREVIOUS PC= F 
a ARP ARO -° ~— ARI TREG PREG ACC CLK 
INTEGER 0 253° 0 5 10 10 37 
_ HEX - "9, «35 eae 5 A. A 25 
>>STK= 0 0 ..0 O- bP 0 


ENTER <CR> TO CONTINUE 


"—" TQ RETURN. TO MAIN 


Figure 4-4. Single-Stepping Through the TMS320C10 Program (Concluded) 


4-8. 


It is now necessary to inspect the memory locations from which the LTD 
instruction fetches its data. The input values stored in locations >33 to 
>36 are expected to be 5,6,6,6, respectively, since the old data values 
were never cleared out of RAM. The RAMH command is entered and 
when these locations are displayed, a 5 is in memory locations >33 
through >35. By carefully examining the program, it becomes clear that 
the value 5 is writing over the next higher address before it gets multi- 
plied in the next filter tap. 


ENTER COMMAND (HELP=<CR>): 
RAMH <CR> 


Aa 

O 
oooccceccc00e00000 Coke) 
P09500099009000000 Wr 
BOO C0222 ooo Tes Ieee hn) 
ODDODDCDDCOCOMODOCCOO ty Wo 
DODDODODCOCOMUDO0CO00O AA 
OODDDCDODDOCOMDOCOOO UHM 
SCOOCDDODDDOOCONDCOOOCO Hn 
DODODDDDDDCOONDOCOOO WA 


ENTER COMMAND (HELP=<CR>): 
Q <CR> 7 


Figure 4-5. Display of TMS320C10 Memory Locations 
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3) Correct the error. 
Since the error is now located, the code can be modified by changing 
all of the LTD *+ instructions to LTD *- instructions. This is because the 
multiplications must start with the oldest data sample in the filter since 
the next higher address is written over before the next multiplication. The 
LARK ARO,XNO must also be changed to LARK ARO,XN4 to begin at 
the last address for the filter taps. Finally, the LT instruction is changed 
to LTD, and the first LTD instruction is changed to LT. 
AORG 10 ;LOAD PROGRAM STARTING AT LOCATION 10. 
YN EQU 50 ;OUTPUT ADDRESS. 
XNO EQU 51 ;FIRST INPUT ADDRESSES. 
XN4 EQU 55 ;LAST INPUT ADDRESSES. 
LARP O | | 
NXTIN IN XNO,PAO ;GET NEW INPUT VALUE XN FROM PORT PAO. 
LARK ARO,XN4 - ;STORE LOCATION AT XNO. 
ZAC ;ZERO ACCUMULATOR. 
* 
LT *— ;3x(n-4) ;h(0)=2. 
MPYK 2 
LTD *— 74x(n-3) ;h(1)=3. 
MPYK 3 
LTD *— :3x(n-2) ;h(2)=4. 
MPYK 4 
LTD <= ;2x(n-1) ;h(3)=3. 
MPYK 3 
LTD x 2>5x(n) ;h(4)=2. 
MPYK 2 
* 
APAC ;ADD RESULT OF LAST MULTIPLY TO 
* ; ACCUMULATOR. 
SACL YN ;STORE RESULT IN YN. 
OUT YN,PA1 ;OUTPUT THE RESPONSE TO PA1. 
B NXTIN ;GET THE NEXT..INPUT VALUE. 
END | 
Figure 4-6. Revised TMS320C10 Program 
4) Test the revised program for accuracy. 


Now that code has been revised, the program is tested again using the 
same procedure sequence as outlined for Step 1. Simulator execution 
begins and the assembled revised code is loaded into the simulator. The 
RUN command is entered for the instructions to be executed. Upon 
entering a 6 when prompted for an input value, the output value is a 30, 


which is the input value multiplied by the first filter coefficient. After 


examining the RAM and finding the value 6 in memory locations >33 
and >34 as it should be to prepare for the next filter input, a C (con- 
tinue) can be entered to examine the results of more inputs. In this ex- 
ample 5, 3,.and 8 are entered with the results of 37, 43, and 85, 
respectively. 
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SIMULATION OF THE TMS320C10 
VERSION # 2.0 


0 - MICROPROCESSOR MODE (ADDR 0-1535, OFF CHIP) 
1 - MICROCOMPUTER MODE (ADDR 0-1535, ON CHIP) 


ENTER VALUE TO SELECT MODE OF OPERATION 
0 <CR> 


YOU ARE IN THE MICROPROCESSOR MODE (ADDR 0-1535, OFF CHIP) 


ENTER COMMAND (HELP=<CR>): 
L. <CR> 


ENTER A NEW OBJECT FILE 
BUG1O.MPO <CR> 
* * * * LOADING PROGRAM "NOSIDT " * * * * 


ENTER COMMAND (HELP=<CR>): 
BIAO <CR> 


BREAK ON INSTRUCTION ACQUISITION. 
ENTER THE ADDRESS (IN HEX) 


1A <CR> 
ENTER COMMAND (HELP=<CR>) : 
RUN <CR> 
>>PC= B OPCODE=4033 IN PREVIOUS PC= 
ARP ARO AR1 TREG PREG ACC 
INTEGER 0 0 0 0 0 0 
HEX 0 0 0 0 0 0 
>>STK= 0 O 0 0 DP = 0 INTF=0 OV =0 
BIO= 1 INTM= 0 OVM= 0 
ENTER INPUT VALUE (IN HEX) OR "-" TO RETURN TO MAIN 
6 <CR> 
* * * OUTPUT VALUE (IN HEX) IS C 
>>PC= 1A  OPCODE=4932 OUT PREVIOUS PC= 
ARP ARO AR1 TREG PREG ACC 
INTEGER 0 50 0 6 12 12 
HEX 0 32 0 6 Cc C 
>>STK= OO 0 0 0 DP = 0 INTF= 0 OV. 


= 0 
BIO= 1 INTM= O OVM= 0 


>>> INSTRUCTION AQUISITION BREAK POINT # 1 <<< 


Figure 4-7. Testing the Revised TMS320C10 Program 


CLK 


19 


CLK 
19 
3 
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ENTER COMMAND (HELP=<CR>) : 


RAMH <CR> 
0 i 2 3 4 5 6 
8 9 A B Cc D E 
0 0 0 0 0 0 © 0 
8 0 0 0 0 0 0 0 
10 © 0 0 © 0 0 0 
18 0 0 0 0 0 0 0 
20 0 0 0 6) 0 0 © 
28 0 0 0 0 0 0 0 
30 0 0 Cc 6 6 0 0 
38 0 0 0 0 0 0 0 
40 0 0 0 0 0 6 0 
48 0 0 6) 0 0 0 0 
50 O © 0 0 0 0 0 
58 0 Ce) 0 0 0 0 0 
60 0 0 0 © 0 0 0 
68 O 0 0 0 0 0 0 
70 0 0 0 0 0 0 0 
78 0 0 0 0 0 0 0 
80 0 0 0 0 0 0 0 
88 0 0 0 0 0 © 0 
ENTER COMMAND (HELP=<CR>): 
C <CR> 
>>PC= B OPCODE=4033 IN | PREVIOUS PC= 1B 
ARP ARO AR1 TREG PREG ACC CLK 
INTEGER 0 50 0 6 12 42 22 
HEX 0 32 0 6 Cc C 16 
>>STK= OO 0 0 0 DP = 0 INTF= 0 OV = 0 
BIO= 1 INTM= 0 OVM= 0 
ENTER INPUT VALUE (IN HEX) OR "-" TO RETURN TO MAIN 
5 <CR> 
* * * OUTPUT VALUE (IN HEX) IS 1C 
>>PC= 1A OPCODE=4932 OUT PREVIOUS PC= 19 
ARP ARO AR1 TREG PREG ACC CLK 
INTEGER 0 50 O 5 10 28 39 
HEX 0 32 0 5 A ike: 27 


>>STK= O O 0 O DP = QO INTF= 0 OV = 0 
BIO= 1 INTM= O OVM= 0 


>>> INSTRUCTION AQUISITION BREAK POINT # 1 <<< 


Figure 4-7. Testing the Revised TMS320C10 Program (Continued) 


Oo0900000000000 00000 (WY~I 
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ENTER COMMAND (HELP=<CR>): 


RAMH <CR> 
) 1 2 3 4 5 
8 9 A B G D 
O 0 6) 0 0 0 0 
8 0 0 0) 0 0 0 
10 6) 0 0 0 0 , ao 
18 0 0 O 0 0 0 
20 0 @) 0 0 0 0 
28 0 ) 0 ) 0 0 
30 0 ) 1c 5 5 6 
38 0 0 O O 0 0 
40 ) @) 6) 0 0 0 
48 0 0 0 0 0 ) 
50 0 6) 0 O 0 0 
58 0 0 ) 0 0 0 
60 0 0 0 0 0 0 
68 0 0 9) 0 0 0 
70 0 0 fe) 0 0 0 
78 0 0 0 0 0 @) 
80 0 0 0 0 0 0 
88 0 @) 0 0 O 0 
ENTER COMMAND (HELP=<CR>): 
C <CR> 
>>PC= B OPCODE=4033 IN PREVIOUS PC= 
ARP ARO AR1 TREG PREG ACC 
INTEGER O 50 @) 5 10 28 
HEX 0 32 © 5 A 1c 
>>STK= 0 0 O 6) DP = 0 INTF= 0 OV=0 
BIO= 1 INTM= 0 OVM= O 
ENTER INPUT VALUE (IN HEX) OR "-" TO RETURN TO MAIN 
3 <CR> 
* * * OUTPUT VALUE (IN HEX) IS 2D 
>>PC= 1A OPCODE=4932 OUT PREVIOUS PC= 
ARP ARO AR1 TREG PREG acc 
INTEGER 0 50 0 3 6 45 
HEX 6) 32 0 3 6 2D. 


>>STK= 0 0 0 0 DP = 0 INTF= 0 OV = 0 
BIO= 1 INTM= 0 OVM= 0 


>>> INSTRUCTION AQUISITION BREAK POINT # 1 <<< 


Figure 4-7. Testing the Revised TMS320C10 Program (Continued) 


OD90O0000 0000000 0000 HN 
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ENTER COMMAND (HELP=<CR>): 


RAMH <CR> 
0 if 2 3 A 5 
8 9 A B Cc D 
0 0 0 0 0 0 0 
8 0 0 0 0 0 0 
10 0 0 0 0 0 0 
18 0 0 0 0 0 0 
20 0 0 0 0 0 0 
28 0 0 0 0 0 0 
30 0 0 2D 3 3 5 
38 0 0 0 0 0 0 
AO 0 0 0 0 0 0 
A8 0 0 0 0 0 0 
50 0 0 0 0 0 0 
58 0 0 0 0 0 0 
60 0 0 0 0 0 0 
68 0 0 0 0 0 0 
70 0 0 0 0 0 0 
78 0 0 0 0 0 0 
80 0 0 0 0 0 0 
88 0 0 0 0 0 0 
ENTER COMMAND (HELP=<CR>): 
Cc <CR> 
>>PC= B OPCODE=4033 IN PREVIOUS PC= 
ARP ARO ARI TREG PREG Acc 
INTEGER 0 50 0 3 6 45 
HEX 0 39 0 3 6 2D 
>>STK= 0 O 0 0 DP = 0 INTF=0 OV =0 
BIO= 1 INTM= 0 OVM= 0 
ENTER INPUT VALUE (IN HEX) OR "-" TO RETURN TO MAIN 
8 <CR> 
* * * OUTPUT VALUE (IN HEX) IS 3F 
>>PC= 1A  OPCODE=4932 OUT PREVIOUS PC= 
ARP ARO ARI TREG PREG acc 
INTEGER 0 50 0 8 16 63 
HEX 0 39 0 8 10 3F 
>>STK= 0 O 0 0 DP = 0 INTF= 0 OV = 0 


BIO= 1 INTM= O OVM= O 


>>> INSTRUCTION AQUISITION BREAK POINT # 1 <<< 


Figure 4-7. Testing the Revised TMS320C10 Program (Continued) 


OVWDVDODOGDOVOOOCOCORnO9D0CO0O00 Fo 
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19 
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ENTER COMMAND (HELP=<CR>):. 


RAMH <CR> 
0 i 2 3 4 5 6 

8 9 A B Ec D E 

0 0 0 0 O* & 0 Ae 0 
8 0 0 0 0 0 0 0 
10. 0 oe. £6 iO; 0 0 0 
18 0 0 oe 0 0 0 0 
20 0 0 0 Os" «lO, ) 0 
28 0 0 0 0 0 0 0 
30 0 0 3F. 8 8 3 5 
38 0 0 oO 0 0 0 0 
40 0 0 oO oOo 0 0 0 
48 0 0 0 AO @ ig 0 0 
50 0 0 0 0 0 0 0 
58 0 0 0 0 0 om O 
60 0 0 0 0 0 0 0 
68 0 0 0 0 0 0 0 
70 0 0 0 0 0 0 0 
78 0 0 0 0 0 0 0 
80 0 0 0 0 0 0 0 
88 0 0 0 0 0 0 0 


ENTER COMMAND (HELP=<CR>): 
Q <CR> 


Figure 4-7. Testing the Revised TMS320C10 Program (Concluded) 


OoOoo00000000N000000 i~i 
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4.2 TMS32020/C25 Debugging Example 


The TMS32020/C25 program in this debugging example attempts to perform 
a simple 5 tap FIR filter of the equation 


x(n-4)h(4) + x(n-3)h(3) + x(n-2)h(2) + x(n-1)h(1) + x(n)h(O) = y(n) 


However, there is a “bug” in the program. The simulator will be used to detect 
the “bug” and correct the code. The sequence of steps in a debugging session 
is followed for this TMS32020/C25 example. 


In the program shown in Figure 4-8, the TMS32020/C25 will prompt the user 
for an input. The value 6 should be entered, and it will be stored at location 
XN. A breakpoint will be set to determine the output of the first pass of the 
filter. According to the program the first data sample, 6, should be multiplied 
by the first filter coefficient, 2, giving an output of 12. Although it may be 
obvious where the “bug” is, the simulator will be used to discover it and cor- 
rect the program. 


AORG >32 ;LOAD PROGRAM STARTING AT LOCATION 32. 
YN EQU 5 ;OUTPUT ADDRESS. 
XN EQU 0 ;FIRST INPUT ADDRESSES. 
XNM4 EQU 4 ;LAST INPUT ADDRESSES. 
LDPK 4 ;POINT TO DATA ‘PAGE 4. 
* 
HX DATA. -2/354)3; 2 
* 
LARP ARO ;USE ARO FOR INDIRECT ADDRESSING. 
LRLK ARO,>200 ;POINT TO BLOCK BO. 
RPTK XNM4 ;N-1 NUMBER OF COEFFICIENTS. 
BLKP HX,*+ 
* 
CNFP ;USE BLOCK BO AS PROGRAM AREA. 
LDPK 6 ;POINT TO DATA PAGE 6. 
NXTIN IN XN,PAO ;GET NEW SAMPLE. 
LRLK AR1,>300 ;POINT TO THE STARTING ADDRESS. 
LARP AR1 ;OF DATA SAMPLES IN BLOCK B1. 
* : 
MPYK 0 ;SET P REG TO O. 
ZAC ;CLEAR ACCUMULATOR. 
RPTK XNM4 ';REPEAT N-1 TIMES. 
MACD >FFOO,*+ ;MULTIPLY/ACCUMULATE. 
APAC ;ADD RESULT OF LAST MULTIPLY TO 
* ; ACCUMULATOR. 
SACL YN ;STORE RESULT IN YN. 
OUT YN,PAl  ;OUTPUT THE RESPONSE TO PAl1. 
B NXTIN ;GET THE NEXT FILTER COEFFICIENT. 
END 


Figure 4-8. TMS32020/C25 Test Program 
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1) 


Test the program on the simulator for accuracy. 


Figure 4-9, page 4-17, illustrates the following procedure, used to test 
the program. 


a) Begin simulator execution. 

b) Configure block BO. 

Cc) Load the program. 

d) Name the file in which the object file i is stored. 
e) Set program counter. 

f) Set breakpoints. 

g) Run the program; enter <CR>. 

h) Enter input value. 

i) View the processor status on the screen. 

j) Note the error (if indicated). 


To begin testing the program, initiate simulator execution by entering the 
proper command (see Section 2 for execution verification). The simu- 
lator next prompts that either a O or a 1 be entered to configure the first 
4K words as internal or external program ROM. Since this program 
performs the correct configuration when desired, a <CR> is entered to 
default. The default configures the first 4K words as internal program 
ROM. 


Next, the L (Load) command is entered to load the program into the 
simulator (see Figure 4-9). The simulator prompts for the filename in 
which the object file is stored. BUGC25.MPO is entered since this is the 
filename for this program. The simulator executes all of the instructions 
it encounters until it is halted by either a <CR>, an interrupt, a branch 
to self, a set breakpoint, or an error. Since a breakpoint will be set at the 
OUT instruction, the simulator will stop further instruction execution. 


When the simulator encounters a breakpoint, it displays the processor 
status. At this time, it can be seen if the program has executed as de- 
sired. This program did not execute correctly since the output is 84 in- 
stead of 12. At this point a RAMH command should be entered to check 
the data RAM. Since the value 6 is in all input value locations, we can 
conclude that the first input sample is being incorrectly multiplied by all 
filter coefficients. 
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(C) COPYRIGHT TEXAS INSTRUMENTS 
INCORPORATED 1986 
TMS320C25 SIMULATOR 
RELEASE 1.0 86.194 


O : First 4k words INTERNAL program ROM 
1 : First 4k words EXTERNAL program ROM 


Enter the memory configuration (0 or 1): <CR> 
First 4k WORDS are mapped on Internal ROM 
COMMAND: L <CR> 


Enter a new object file : BUGC25.MPO <CR> 
**** LOADING PROGRAM "NOSIDT  ¥x** 


COMMAND: PC <CR> 


Present value for program counter : 0 
Enter a new value for the PC (in Hex) : 2 <CR> 


COMMAND: BIAQO <CR> 
BREAK ON INSTRUCTION ACQUISITION 
ENTER THE ADDRESS (IN HEX): 4B <CR> 


COMMAND: RUN <CR> 


PC :0032 ADD >0200 | C25 MP 
-1 :0000 ADD >0200 IFR :QO0O0O000 STO:0604 ST1 :07F0O BIO 
-2 :0000 ADD >0200 IMR :QOO00000 ARB:0 ARP :0 NFD 
-3 :0000 ADD >0200 MMRS CRY 22 DP :04 FO :0 
STACK DRR :O000 FSM:1 INTM: 1 OV :0 
ARO: OOOO SKO: OOOO] DXR :0000 OVM:0 PM :0 SXM:1 
ARI: 0000 SK1: OO00] TIM :FFFF i Comes 8) TXM :0 XF :1 
AR2: 0000 SK2: 0000] PRD :FFFF OUTP: 0000 
AR3: 0000 SK3: 0000] GREG: 0000 RPTC: 0 CLK: 0 
AR4: 0000 SK4: OOOO 
AR5: 0000 SK5: 0000 TREG: 0000 
AR6: 0000 SK6: 0000 PREG: O0O0O0O0000 
AR7: 0000 SK7: 0000 ACC : 00000000 
Enter input value (in HEX) or "-" to return to main: 6 <CR> 
After entering the value of 6, the screen displays the following: 
PC :O004C B >0040,* C25: 
-1 :004B OUT >0305,>1 IFR : 000000 STO:2606 ST1 :15F0O BIO 1 
-2 :004A SACL>0O305 IMR : 000000 ARB:0 ARP :1 CNFD 
-3 :0049 APAC MMRS CRY :0 DP :06 FO :0 
STACK DRR : 0000 FSM:1 INTM: 1 OV :0 
ARO: 0205 SKO: O000 | DXR :0000 OVM: 0 PM :0 SXM:1 
AR1: 0305 SK1l: OOOO] TIM :FFD8 TC :0 TXM :0 XF :1 
AR2: OOOO SK2: OO00] PRD :FFFF OUTP:0054 | 
AR3: 0000 SK3: O0O00 | GREG: 0000 RPTC: 0 CLK: 39 
AR4: 0000 SK4: O0O00 
AR5: 0000 SK5: QO0O0 TREG: 0006 
ARO: 0000 SK6: OO00 PREG: OO0OQO0000C 
AR7: 0000 SK7: Q0O00 ACC : 00000054 


>> instruction acquisition breakpoint # 1 << 


Figure 4-9. Error Revealed in Tested TMS32020/C25 Program 


4-17 
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COMMAND: 


RAMH <CR> 


Enter start DATA address (in Hex): 300 <CR> 


COMMAND: 


Figure 4-9. Error Revealed in Tested TMS32020/C25 Program (Concluded) 


2) 


Locate the error. 


noue 4-10, pages 4-18 through 4-20, illustrates the following proce- 
ure. 


Enter a new PC value. 


& 

@ Single step through the program, viewing the results of each in- 
struction. 

® 


When an error is located, inspect the memory locations for that 
instruction. 


® Locate the error in memory. 


Since the program did not resuit with the desired number for an output, 
the next step is to locate the error. To reset the program the P register 
and T register must be cleared. This is done by entering P <CR>. After 
being prompted for a new value, enter 0. Do the same for the T register. 
Next, the simulator is reset using the RS command, and an additional 
breakpoint is added at the LACK instruction (address 45). From this 
point the program will be single stepped through to determine the cause 
of the error. In this pass the value 5 should be entered for an input value 
so that it can be distinguished form the previous input value. 


COMMAND: PC <CR> 


Present value for program counter : OO4C 
Enter a new value for the PC (in Hex) : 2 <CR> 


COMMAND: CNF <CR> 


Present value of ram configuration control bit :0001 
O - Onchip memory block BO is Data RAM 
1 - Onchip memory block BO is Program ROM 

Enter new value : Q <CR> 


COMMAND: P <CR> | , 
Present value of the P register: OOOC 
Enter new value (in HEX): Q <CR> 


COMMAND: T <CR> 
Present value of the T register: O006 


Enter new value (in HEX): Q <CR> 


Figure 4-10. Single-Stepping Through the TMS32020/C25 
Program 
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COMMAND 


COMMAND 


PC 
=. 
= 2 
=3 


: BIAQ <CR> 
Break on instruction acquisition 
Enter the address (in HEX): 45 <CR> 


: RUN <CR> 
20032 B >0040 
:004B OUT >0305 
:O004A SACL>O305 
:0049 APAC 

ARO: 0205 

ARI: 0305 

AR2: 0000 

AR3: 0000 

AR4: 0000 

AR5: 0000 

AR6: 0000 

AR7: 0000 


Enter input value (in HEX) or 


Pa 
ips 
STACK 

SKO: 0000 
SK1: 0000 
SK2: 0000 
SK3: 0000 
SK4: 0000 
SK5: 0000 
SK6: 0000 
SK7: 0000 


LA 


to return to main: 5 <CR> 


After entering the value 5, the screen displays the following: 


12 
aie 
=2 
=3 


>0046 
:0045 
:0044 
:0043 


RPTK>O4 
ZAC 
MPYK>OOO0O0 
LARP >1l 


0205 
0300 
0000 
0000 
0000 
0000 
0000 
0000 


STACK 
SKO: O0O00 
SK1: 0000 
SK2: 0000 
SK3: 0000 
SK4: 0000 
SK5: O0O00 
SK6: 0000 
SK7: O000 


C25 MP 
IFR : 000000 STO:2606 ST1 :O5FO BIO 1 
IMR : 000000 ARB: 0 ARP :1 CNFD 
MMRS CRY:0 DP :06 FO :0 

DRR : 0000 FSM:1 INTM: 1 OV :0 
DXR : 0000 OVM:0 PM :0 SXM:1 
TIM :FFD8 TC :0 TXM :0 XF :1 
PRD :FFFF OUTP:0054 
GREG: 0000 RPTC: e) CLK: 39 

TREG: 0000 

PREG: O0O0O00000 

ACC 00000054 

C25 MP 
IFR : 000000 STO:2606 ST1 :15FO BIO 1 
IMR :OO00000 ARB:0 ARP :1 CNFED 
MMRS CRY:0 DP 06 FO :0 

DRR : 0000 FSM: 1 INTM: 1 OV :0 
DXR : 0000 OVM: 0 PM 0 SXM:1 
TIM :FFBD TC :0 TXM :0 XF :1 
PRD :FFFF OUTP:0005 
GREG: 0000 RPTC: 0 CLK 66 

TREG: 0000 

PREG: O0OO00000 

ACC OO000000 


>> instruction acquisition breakpoint # 2 << 


Figure 4-10. Single-Stepping Through the TM$32020/C25 Program (Continued) 


At this point all of the registers are correct, soa RAMH command is used 
to check the data RAM. The input, 5, ts in the first location as expected, 
so the program is assumed to be correct up to this point. Next the SS 
(single-step) command is used. The next instruction (RPTK) appears 
correct. However, the MACD instruction is incorrect because a 6, not a 
5, should be loaded into the T register. 
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COMMAND: 


RAMH <CR> 


Enter start DATA address 


300 
308 
310 
318 
320 
328 
330 
338 


0005 
0000 
0000 


0000 


0000 
0000 
0000 
0000 


0006 
0000 
0000 
0000 
0000 
0000 
0000 
0000 


(in Hex) 300 <CR> 

0006 O006 0006 0054 0000 OO000 
0000) 60000) =6©0000)=6=60000)=60000—)—S(—0000 
0000 O000 oO000 O000 O000 O000 
0000 .0000 o0000 0000 O000 O000 
0000 0000 O0000 0000 0000 = O000 
0000 0000 0000 O000 O000 O000 
0000 0000 oO000 oO000 o000 0000 
0000 0000 O000 O000 0000 


Now, Single Step (SS) the simulator to locate the program “bug”. 


COMMAND : 


PC 
-1 
=2 
-3 


:0047 
:0046 
>O004A 
70049 


ARO: 
ARI: 
AR2: 
AR3: 
AR4: 
AR5: 
ARO: 
AR7: 


SS <CR> 


MACD>FFOO, *+ 
RPTK>O4 


ZAC 


MPYK>OOOO 


0205 
0300 
0000 
0000 
0000 
0000 
0000 
0000 


STACK 
SKO: 0000 
SK1: 0000 
SK2: 0000 
SK3: 0000 
SK4: 0000 
SK5: 0000 
SK6: 0000 
SK7: 0000 | 


*Execute RPTK instruction* 


<CR>:continue <->:return to main <D>:display mode 


<CR> 


270049 
:0047 
:O004A 
:0049 


PC 
= 
= 
= 3 


ARO: 
ARI: 
AR2: 
AR3: 
AR4: 
AR5: 
AR6: 
AR7: 


<CR>:continue <->:return to main <D>: 


= <CR> 


APAC 
MACD>FFOO, *+ 
RPTK>04 
ZAC 

STACK 
0205 SKO: 0000 
0305 SK1: 0000 
0000 SK2: 0000 
0000 SK3: 0000 
0000 SK4: 0000 
0000 SK5: 0000 
0000 SK6: 0000 
0000 SK7: 0000 


C25 MP : 
IFR : 000000 STO:2606 ST1 :15F0 
IMR :O00000 ARB:0 ARP :1 
MMRS CRY:0 DP 2:06 
DRR : 0000 FSM:1 INTM: 1 
DXR : 0000 OVM:0 PM :0 
TIM :FFBC TC :0 TXM :0 
PRD :FFFF OUTP:0005 
GREG: 0000 RPTC: 4 CLK: 
TREG: 0000 
PREG: QOOO0Q00000 
ACC 00000000 
*Execute MACD instruction" 
= C25 MP 
IFR :O000000 STO:2606 ST1 :15F0 
IMR :O00000 ARB: 0O ARP :1 
MMRS— CRY:0 DP :06 
DRR : 0000 FSM:1 INTM: 1 
DXR : 0000 OVM:0 PM :0 
TIM :FFD8 TC. £0 “TXM :0 
PRD :FFFF OUTP:0005 
GREG: 0000 RPTC: O CLK: 
TREG: 0005 
PREG: OOOOO00A 
ACC OO000003C 


display mode 


Figure 4-10. Single-Stepping Through the TMS32020/C25 Program 
(Concluded) 
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BIO 1 
CNFD 
FO :0 
OV :0 
SXM:1 
XF :1 


67 


BIO 1 
CNFD 
FO :0 
OV :0 
SXM:1 
XF :1 


75 
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3) 


It is now necessary to inspect the memory locations from which the 
MACD instruction fetches its data. The input values stored in locations 
>300 to >305 are expected to be 5,6,6,6 respectively since the old data 
values were never cleared out of RAM. The RAMH command is entered, 
and when these locations are displayed, a 5 is in memory locations >300 
through >305. By carefully examining the program, it becomes clear 
that the value 5 is writing over the next higher address before it gets 
multiplied in the next filter tap. 


COMMAND: RAMH <CR> 


Enter start DATA address (in Hex): 300 <CR> 


300 0005 0005 0005 O005 0005 0005 0000 £OOO00 
308 0000 0000 0000 0000 0000 oO000 O000 O000 
310 0000 0000 0000 0000 0000 0000 0000 0000 
318 0000 0000 0000 O000 0000 0000 O000 £OO000 
320 0000 0000 0000 O0000 oO000 O000 O000 = OO0O0D 
328 0000 0000 0000 O000 0000 0000 oO000 - O000 
330 0000 0000 O0000 0000 O000 0000 O000- O000 
338 O000 0000 O0000 O000 O000 oO000 O000 O000 
Figure 4-11. TMS32025 Memory Locations in Block B1 
Correct the error. 


Since the error is now located, the code can be modified by changing 


the *+ to *- in the MACD instruction. The multiplications must start with 
the oldest samples in the filter since the next higher address is written 
over before the. next multiplication. The LRLK AR1,>300 must also be 
changed to LRLK AR1,>304 to begin at the last address for the filter 
taps. 
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~ 4-22 


NXTIN 


>32  ;LOAD PROGRAM STARTING AT LOCATION 32. 
5 ;OUTPUT ADDRESS. 

0 ;FIRST INPUT ADDRESSES. 

4 ;LAST INPUT ADDRESSES. 

4 ;POINT TO DATA PAGE 4. 

273 4,332 

ARO ';USE ARO FOR INDIRECT ADDRESSING. 
ARO,>200 ;POINT TO BLOCK BO. 

XNM4  ;N-1 NUMBER OF COEFFICIENTS. 

HX, *+ 


;USE BLOCK BO AS PROGRAM AREA. 
© ;POINT TO DATA PAGE 6. 


XN,PAO ;GET NEW SAMPLE. 


AR1,>304 ;POINT TO THE STARTING ADDRESS. 


AR1 ;OF DATA SAMPLES IN BLOCK B1. 
Oo ;SET P REG TO 0. 

;CLEAR ACCUMULATOR. 
XNM4 ;REPEAT N-1 TIMES. 


>FFOO,*- ;MULTIPLY/ACCUMULATE. 
;ADD RESULT OF LAST MULTIPLY TO 


; ACCUMULATOR. 
YN ;STORE RESULT IN YN. 
YN,PAI1 ;OUTPUT THE RESPONSE TO PAI. 
NXTIN ;GET THE NEXT FILTER COEFFICIENT. 


Figure 4-12. Revised TMS32020/C25 Program 


4) Test the revised program for accuracy. 


Now that the code has been revised, the program is tested again using 
the same procedure outlined for Step 1. Simulator execution begins and 
the assembled revised code is loaded into the simulator. The RUN 
command is entered for the instructions to be executed. Upon entering 
a 6 when prompted for an input value, the output value is 12 which is 
correct. Continuing, we enter the values 5 and 4 giving the outputs 28 
and 47, respectively. The code has been debugged and ts now accurate. 
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(C) COPYRIGHT TEXAS INSTRUMENTS 
INCORPORATED 1986 
TMS320C25 SIMULATOR 
RELEASE 1.0 86.194 


O : First 4k words INTERNAL program ROM 
1 : First 4k words EXTERNAL program ROM 


Enter the memory configuration (0 or 1): <CR> 


First 4k WORDS are mapped on Internal ROM 
COMMAND: L <CR> 


Enter a new object file : BUGC25.MPO <CR> 
***k* LOADING PROGRAM "NOSIDT " **** 


COMMAND: PC <CR> 


Present value for program counter : O 
Enter a new value for the PC (IN HEX) : 32 <CR> 


COMMAND: RUN <CR> 


PC :0032 ADD >0200 C25 MP 
-1 :0000 ADD >0200 IFR : 000000 STO:0604 ST1 
-2 :0000 ADD >0200 IMR :000000 ARB:0 ARP 
-3 :0000 ADD >0200 MMRS CRY:1 DP 
STACK DRR :O000 FSM:1 INTM 
ARO: 0000 SKO: 0000 | DXR :0000 OVM:0 PM 
ARI: 0000 SK1l: OOOO | TIM :FFFF . TC: 20 TXM 
AR2: 0000 SK2: OOOO | PRD :FFFF OUTP: 0000 
AR3: 0000 SK3: 0000 | GREG: 0000 RPTC: 0 
AR4: 0000 SK4: 0000 , 
ARS: 0000 SK5: 0000 TREG: 0000 
AR6: 0000 SK6: O000 PREG: 00000000 
AR?7: 0000 SK7: OOOO ACC : OO000000 
Enter input value (in HEX) or "-" to return to main: 6 <CR> 


Figure 4-13. Testing the Revised TMS320C0/C25 Program 


:O7FO BIO 1 
20 CNFD 
:04 FO :0 
1 OV :0 
:0 SXM:1 
0 XF :1 
CLK: 0 
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After entering the value of 6, the output (OUTP) changes to 12. 


» PC.:0032 ADD.>0200 : C25 MP 
=1:0000 ADD >0200 IFR :000000 §T0:2606 ST1 :15F0 
-2 :0000 ADD.>0200 IMR : 000000 ARB: 0 ARP :0 
-3 :0000 ADD >0200 .. i MMRS CRY:1 |. DP §:04 
—— : STACK——j| DRR :.0000 FSM:1 .. INTM:1 
ARO: 0000. SKO: 0000 | DXR:':0000 . OVM:0 PM :0 
-AR1: 0000 SK1: 0000 | ‘TIM. :FFFF TC :0  TXM :0 
AR2: 0000: SK2: 0000 | PRD :FFFF OUTP:000C | 
~ AR3; 0000 . SK3: O0O00 |:GREG: OOOO ~  RPTC: #£#O CLK: 
--AR4: 0000 . SK4: O000 : 
AR5: OOOO. | SK5: OOOO ..TREG: 0000 
AR6: 0000 SK6: 0000 ' PREG: . 00000000 
AR7: 0000 SK7:. 0000 ~ ACC : OO0O000000 
Enter input value (in HEX) or "-" to return to main: 5 <CR> 
After entering the value of 5, the output (OUTP) changes to 28. 
PC :0032 ADD >0200 C25 :MP 
-1 :0000 ADD >0200 IFR :000000 STO:2606 ST1 :35F0 
-2 :0000 ADD >0200 IMR :000000 ARB: 0 ARP :0 
-3 :0000 ADD >0200 : MMRS CRY <1 DP :04 
, STACK DRR : 0000 FSM: 1 INTM: 1 
ARO: 0000 SKO: OOOO | DXR : 0000 OVM: 0 PM  :0 
AR1: OOOO SKi: OOOO | TIM :FFFF TC :0 TXM :0 
AR2: 0000 SK2: QOOO | PRD : FFFF OUTP:001C 
AR3: 0000 SK3: 0000 | GREG: 0000 RETC: 0 CLE: 
AR4: 0000 SK4: 0000 7 
ARD5: 0000 SK5: OOOO TREG: 0000 . 
AR6: 0000 SK6: OO0O00 PREG: OO0Q000000 
AR7: 0000 SK7: OOOO ACC 00000000 
Enter input value (in HEX) or "-" to return to main: 4 <CR> 
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BIO 1 
CNFD 
FO :C 
OV :C 
SXM: 1 


XF :1 


0 


Figure 4-13. Testing the Revised TMS320C0/C25 Program (Continued) 
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After entering the value of 4, the output (OUTP) changes to 47. 


PC :0032 ADD >0200 C25 MP 
-1 :0000 ADD >0200 IFR : 000000 STO:2606 ST1 :35FO BIO 1 
-2 :0000 ADD >0200 IMR : 000000 ARB:0 ARP :0 CNFD 
-3 :0000 ADD >0200 MMRS CRY:1 DP :04 FO :0 
STACK DRR :O000 FSM:1 INTM: 1 OV :0 
ARO: 0000 SKO: OOOO | DXR :0000 OVM:0 PM :0 SXM:1 
AR1: 0000 SK1l: OOOO |] TIM :FFFF The 38:0 TXM :0 XF :1 
AR2: 0000 SK2: OO0O0O0 | PRD :FFFF OUTP:002F 
AR3: 0000 SK3: 0000 | GREG: 0000 RPTC: O CLK: O 
AR4: 0000 SK4: 0000 
AR5: 0000 SK5: OOOO TREG: 0000 
ARO: 0000 SK6: 0000 PREG: O0O000000 
AR?7: 0000 SK7: QOO0O0 ACC : QOQO00000 
Enter input value (in HEX) or "-" to return to main: 


Figure 4-13. Testing the Revised TMS320C0/C25 Program 


(Concluded) 
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Appendix A 


Table A-1 lists the TMS320 Simulator run-time stop codes that may occur 
during program execution. One of these stop codes is displayed each time 
program execution is suspended. Those stop codes that appear only when a 
particular device is used are indicated by the device number enclosed in pa- 
rentheses following the stop-code definition. 


The following stop codes (2600, 2780, 3505, 4190, 8683, and 9105) are il- 
legal trap codes, and indicate the existence of states that do not occur in a 
properly functioning simulator. 


Simulator Stop Codes 


Table A-1. Simulator Stop Codes 


| Illegal trap — | ! 
; 2695 Break on data read | 


2780 ‘| Illegal trap } 
| 2795 | Break on output write 


Definition poe ee ee 


3505 | Itlegal trap 
| 3665 | Break on table read 


_Break on table write 


| 4065 | Break on table write 


legal trap 


| 5000. ~——s{_- <CNTRL-C> 


Ss 
—_ 
© 
© 


Negative operand not allowed for SUBC instruction (TMS32020, 
| TMS320C25). 


| Data memory address must be in the range of 65280 to 65535 inclusive 
| (TMS32020, TMS320C25). : | 


Data memory address must be on-chip (TMS32020, TMS320C25). | 


| CNF must equal 1 for MAC and MACD instructions (TMS32020, 
| TMS320C25). | 


| Illegal opcode 


| Break on instruction acquisition 


(legal indirect addressing structure (bits 1,2, and 6 not zero) 


70 |__Illegal indirect addressing structure (bits 4 and 5 are both on). _ | 
8680 | Break on data memory read (during development of indirect addressing) _ 
8683 | Illegal trap | | | | 


| _ 9020 | Break oninstruction acquisition = 
‘| Accumulator was used the first cycle after SUBC (TMS32010). | 
[Steps"epied SSCS 
|___10144 | Addressed beyond end of 144-word data RAM (TMS32010) 
10400 Error breakpoint (over/underflow, etc.) 

| 10496 | Addressed beyond end of 4096-word program ROM (TMS32010) | 
Instruction acquisition breakpoint #N 

| 12000+N | Program ROM breakpoint #N | 


13000+N _ | Data RAM breakpoint #N 


A-2 


Index 


> 


ACC 
Modify 
Inspect Accumulator 3-9 
accumulator 3-9 


Modify 
Inspect Auxiliary Registers 3-10 
ARB 


Modify 
Inspect Auxiliary Register 3-11 
ARP 


Modify 
Inspect Auxiliary Register 
Pointer 3-12 
Assign RCV Channel to File (TMS320C25) 
RCV 3-75 
Assign XMT Channel to file (TMS320C25) 
XMT 3-115 
auxiliary register pointer 3-12 
auxiliary register pointer buffer 3-11 
auxiliary registers 3-10 


BDP 
Breakpoint on Data Pattern 3-14 
BDR 
Breakpoint on Data RAM Read 3-15 
BDRW 
Breakpoint on Data RAM Read and 
Write 3-16 
BDW 
Breakpoint on Data RAM Write 3-17 
BER 
Breakpoint on an Error 
Condition 3-18 
BH 
Breakpoint Help Menu 3-20 
AQ 


Breakpoint on Instruction 
Acquisition 3-21 
BIO 3-22 
Modify 
Inspect | O Branch Control 
BPP 


Breakpoint on Data Pattern 3-23 
R 


Breakpoint on Program ROM 
Read 3-24 
Breakpoint Help Menu 
BH -20 


Breakpoint on an Error Condition 


BER 3-18 

Breakpoint on Data Pattern 
BDP 3-14 
BPP 3-23 

Breakpoint on Data RAM Read 
BDR 3-15 


Breakpoint on Data RAM Read and Write 
BDRW 3-16 
Breakpoint on Data RAM Write 
BDW 3-17 
Breakpoint on Instruction Acquisition 
BIAQ 3-21 
Breakpoint on Program ROM Read 
BPR 3-24 
breakpoints 3-14, 3-15, 3-16, 3-17, 
3-18, 3-20, 3-21, 3-23, 3-24, 3-29, 3-59, 
3-74 


C 


Cc 

Continue the Simulation 3-25 
carry bit 3-28 
CC 


Modify 
Inspect Clock Counter 3-26 
clock 3-26, 3-105, 3-106, 3-117 
Close RCV Channel File (TMS320C25) 
RCVC 3-76 
Close the (XMT) Channel File 
(TMS320C25) 
XMTC 3-116 
CNF 
Modify 
Inspect RAM 
Configuration 3-27 
commands 3-1 
command set summary 3-3 
control operations 3-2 
[/O simulation 3-120 
Continue the Simulation 


Index-1 


C 3-25 
Y 


Modify: | 
Inspect Carry Bit 
(TMS320C25) 3-28 


D 


data memory page pointer 3-34 
data RAM 3-27, 3-68, 3-70, 3-72 
DB 
Display Breakpoints 3-29 
C 


Display Control Manager 
(TMS320C25) 3-30 
DCL 
Enable Digital Command 
Language 3-31 
debug session 4-1 
TMS320C10 debugging 
example 4-2 
TMS32020/C25 debugging 
example 4-15 


Display Help Menu 
(TMS320C25) 3-32 
digital command language 3-31 

Disable TIC Commands 
ZTIC 3-119 
Display 
Update Register Status 
ST 3-95 
Display Breakpoints 
DB - 
display control 3-32 
Display Control Manager (TMS320C25) 
DC 3-30 
Display Data RAM in Hex 
RAMH 3-70 
Display Data RAM in Integer 
~ RAMI 3-72 
Display Help Menu (TMS320C25) 
DH 3-32 : 


Display Main Menu 
DM -33 

Display Program ROM in Hex 
ROMH~ 3-80 

Display Program ROM in Integer 
ROMI 3-82 

Display Trace Buffer 
DT 5 


DM 


index-2 


Display Main Menu 3-33 
P 


Modify 
- Inspect Data Memory Page . 
Pointer 3-34 
DT : : | 
Display Trace Buffer 3-35 
DWAIT — | 
Specify Wait Cycles 3-36 


E 


EH 
Execution Help Menu 
(TMS320C25) 3-37 
Enable Digital Command Language 
DCL 3-31 
ERAM , 
Expand RAM and ROM 
(TMS320C10) 3-38 
EX 
Execute Commands from Given 
File 3-39 — 
Execute Commands from Given File 
EX 3-39 
execution 3-37 4 
execution commands 3-25, 3-38, 3-39, 
3-66, 3-67, 3-94 7 
Execution Help Menu (TMS320C25) 
EH 3-37 | 
execution verification 2-1 
TMS320C10 2-8 
mode selection 2-8 
TMS320C25 2-13 | 
memory map configuration 2-13 
Expand RAM and ROM (TMS320C10) 
ERAM- 3-38 


r 


FO 
Modify ! 
Inspect Format Bit | 
(TMS32020 C25) 
format bit 3-40 
frame sync mode _ 3-41 
FSM ? 
Modify 
Inspect Frame Sync Mode 
(TMS320C25) 3-41 


G 
Generate Test Data (TMS320C25 VAX 
VMS) 
SGN 3-87 
H 
HM 
Modify 


Inspect Hold Mode Bit 
(TMS320C25) 3-42 
hold mode bit 3-42 


[/O 93-22, 3-47, 3-48, 3-54, 3-55, 3-56, 
3-86, 3-88, 3-92 
Input 
Output Help Menu 
IOH 3-47 
instruction counter 3-84 
instruction set 
execution time 1-2 
Interrupt 
Timing Help Menu (TMS32020 
C25) TICH 
interrupt flag mode register 3-45 
interrupt flag register 3-43 
interrupt flags 3-44 
interrupt masks 3-46 


interrupts 3-36, 3-43, 3-44, 3-45, 3-46, 
3-48, 3-65, 3-105, 3-106, 3-107, 3-108, 
3-109, 3-119 

INTF 

Modify 


Inspect Interrupt Flag Register 
(TMS320C10) 3-43 
INTFS 


Modify 
Inspect Interrupt 3-44 
INTM 
Modify 
Inspect Interrupt Mode 
Register 3-45 
INTMS 


Modify 
Inspect Interrupt 3-46 


1OH 
Input 
Output Help Menu 3-47 
IOWAIT | 
Specify Wait Cycles for 3-48 


J 


JF 
Select Journal File 3-49 
journal files 3-39, 3-49 


L 


L 
Load New Object File 3-52 
LC 
Load New COFF Files (TMS32020 
C25) 3-53 | 
LF 


List Files Assigned to Ports 
(TMS320C10) 3-54 


List Files Assigned to Input Ports 
(TMS32020 
C25) 3-55 
Link Editor 1-2, 4-1 
List Files Assigned to Input Ports 
(TMS32020 
C25) 
L! 3-55 
List Files Assigned to Output Ports 
(TMS32020 
C25 
LO 3-56 
List Files Assigned to Ports (TMS320C10) 
LF 3-54 
LO 
List Files Assigned to Output Ports 
(TMS32020 
C25) 3-56 
Load New COFF Files (TMS32020 
C25) 
LC 3-53 
Load New Object File 
L 3-52 


Load RAM Data from 
LRAM 3-57 
LRAM 
Load RAM Data from 3-57 


Index-3 


M 


Macro Assembler 1-2, 4-1 
MH 


Modify 
_.. Inspect Memory Help 
Menu 3-58 
Modify 
_Inspect Accumulator 
ACC 


Inspect Auxiliary Register 
Inspect Auxiliary Register Pointer 
ARP 3-12 
Inspect Auxiliary Registers 
AR 0 


Inspect Carry Bit (TMS320C25) 
CY -28 
Inspect Clock Counter 
CC 3-26 
Inspect Data Memory Page Pointer 
DP 4 


Inspect Format Bit (TMS32020 
C25) FO 
Inspect Frame Sync Mode 
(TMS320C25) 
FSM 3-41 
Inspect Hold Mode Bit (TMS320C25) 
HM 3-42 
Inspect | 
O Branch Control BIO 
Inspect Individual Data RAM 
RAM 3-68 
Inspect Individual Prog ROM Lo- 
cations 
ROM 3-78 
Inspect Interrupt 
INTFS 3-44 
INTMS 3-46 
Inspect Interrupt Flag Register 
(TMS320C10) 
INTF 3-43 
Inspect Interrupt Mode Register 
INTM 3-45 
Inspect ee Help Menu 
Inspect Overflow Flag Register 
OV 3-60 
Inspect Overflow Mode Register 
OVM 3-61 
Inspect P Register 
P 2 


Inspect Product Shift 


Index-4 


PM 3-64 
Inspect Program Counter 
PC 3-63 
Inspect RAM Configuration 
CNF 3-27 
Inspect Registers 
Flags Help Menu RH 
Inspect Repeat Counter (TMS32020 . 
C25) RPTC 
Inspect Sign-Extension 
SXM 3-101 
Inspect Stack 
SK 3-90 
Inspect Status Registers 
Pins STH 
Inspect T Register 
T 3-102 
Inspect Timer 
TINT 3-108 
TINTM 3-109 
Inspect Transmit 
TXM 3-111 
Inspect XF Pin (TMS32020 
C25) XF 
Inspect XINTM Bit (TMS320C25) 
XINTM 3-114 
MS/PC-DOS 1-1, 1-2, 2-5, 3-71, 3-73; 
3-80, 3-82 


N 


NB 

Number of Instructions 3-59 
notation 3-32 
Number of Instructions 

NB 3-59 


O 


OV 
Modify 
Inspect Overflow Flag 
Register 3-60 
overflow flag register 3-60 
overflow mode register 3-61 
OVM 
Modify 
Inspect Overflow Mode 
Register 3-61 


P 


P 
Modify 
Inspect P Register 3-62 
P register 3-62 
PC 


Modify 
Inspect Program Counter 3-63 
PM 


Modify 
Inspect Product Shift 3-64 
product shift mode field 3-64 
program counter 3-63 
program ROM _~ 3-27, 3-78, 3-80, 3-82 
PWAIT 


Specify Wait Cycles for External 3-65 


0 


Q 

Quit Simulation 3-66 
Quit Simulation 

Q 3-66 


R 


R 

Run Simulation 3-67 
RAM 

Modity 

Inspect Individual Data 
RAM 3-68 

RAMH 

Display Data RAM in Hex 3-70 

AMI 


Display Data RAM in Integer 3-72 
B 


Remove Breakpoint 3-74 
RCV 
Assign RCV Channel to File 
(TMS320C25) 3-75 
RCV channel file 3-75, 3-76 
RCVC 
Close RCV Channel File 
(TMS320C25) 3-76 
Remove Breakpoint 


reset 3-85, 3-86 
Reset Selected Input Port File 


RS| 3-86 
Reset Simulator 
RS 3-85 


RH 
Modify 
Inspect Registers Flags Help 
Menu 
ROM 
Modify 


Inspect Individual Prog ROM Lo- 


cations 3-78 
ROMH 
Display Program ROM in Hex 3-80 
ROMI 
Display Program ROM in 
Integer 3-82 


Modify 
Inspect Repeat Counter 
(TMS32020 (C25) 
RS 


RS! 


Reset Simulator 3-85 


Reset Selected Input Port File 3-86 
Run Simulation 
R 3-67 


S 


Save Trace Buffer 
STR 3-99 
Select Input Port File 
S| 3-88 
Select Journal File 
JF 3-49 
Select Output Port File 
SO 3-92 
Serial port RCV channel 3-75, 3-76 
Set RAM Contents to Zero (TMS32020 
C25) 
ZRAM 3-118 
SGN 


Generate Test Data (TMS320C25 VAX 


VMS) 3-87 


Select Input Port File 3-88 
sign-extension mode bit 3-101 
SIM 

Simulator Mode Command 


(TMS32020 
C25) 3-89 
simulator 


commands 3-1 
debug session 4-1 
description 1-2 
execution verification 2-1 
key features 1-3 
stop codes A-1 

simulator installation 2-1 
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MS/PC-DOS 2-5 
VAX/VMS 2-2 
Simulator Mode Command (TMS32020 
C25) 
SIM 3-89 
Single Step 
SS 3-94 
SK 
Modify 
inspect Stack 3-90 
SO 


- Select Output Port File 3-92 
Specify Clock Tics until 
TICO-TIC2 3-106 
Specify Clock Tics until Next Interrupt 
(TMS320C10) 
TIC 3-105 
Specify Wait Cycles 
DWAIT 3-36 
Specify Wait Cycles for 
IOWAIT 3-48 
Specify Wait Cycles for External 
PWAIT 3-65 
SRAM 
Store RAM Data 3-93 


S 
Single Step 3-94 
7 


Display 
Update Register Status 3-95 
stack 3-90 
status register 3-98 
STH 


Modify 
Inspect Status Registers Pins 
stop code listing A-1 
Store RAM Data 
SRAM 3-93 
STR 
Save Trace Buffer 3-99 
SW 
Switch from Screen to File 
(TMS32020 
C25) 3-100 
switch from screen to file 3-100 
Switch from Screen to File (TMS32020 


C25) 
SW 3-100 
SXM 
Modity 
Inspect Sign-Extension 3-101 
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Modify 
Inspect T Register 3-102 
T register 3-102 
test dataon RAM 3-87 
test/control flag bit 3-103 
TH 


Trace Help Menu (TMS320C25)_ 3- 
104 


TIC . 
Specify Clock Tics until Next Interrupt 
(TMS320C10) 3-105 
TICH 
Interrupt 
Timing Help Menu 
(TMS32020 C25) 
TICO-TIC2 
Specify Clock Tics until 3-106 
timer interrupt mask 3-109 
timing 3-36, 3-48, 3-65, 3-105, 3-106, 
3-107, 3-119 
TINT 
Modify 
Inspect Timer 3-108 
TINTM 
Modify 
Inspect Timer 3-109 
Toggle Trace Mode 
TR 3-110 
TR 
Toggle Trace Mode 3-110 
trace 3-104 
trace buffer 3-35, 3-99, 3-110 
Trace Help Menu (TMS320C25) 
TH 3-104 
trace mode 3-110 
transmit mode bit 3-111 
TXM 7 
Modify 
Inspect Transmit 3-111 


U 
utilities 3-112 


Utilities Help Menu (TMS32020 | 


C25) 
UTLH 3-112 
UTLH 
Utilities Help Menu (TMS32020 
C25) 3-112 


V 


variable format 3-30 
VAX/VMS 
3-73, 3-81, 3-83 


WwW 


wait cycles 3-36, 3-48, 3-65 


X 


XF 
Modify 
Inspect XF Pin 
(TMS32020 C25) 
XINTM 


Modify 
Inspect XINTM Bit 


(TMS320C25) 3-114 


1-1, 1-2, 2-2, 3-70, 3-72, 


XMT 
Assign XMT Channel to file 


(TMS320C25) 3-115 
XMTC 
Close the (XMT) Channel File 
(TMS320C25) 3-116 
Z 
Z 
Zero Clock Counter 3-117 
Zero Clock Counter 
Z 3-117 
ZRAM 
‘Set RAM Contents to Zero 
(TMS32020 
C25) 3-118 
ZTIC 


Disable TIC Commands 3-119 
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TI Sales Offices 


ALABAMA: Huntsville (205) 837-7530. 


ARIZONA: Phoenix (602) 995-1007; 
Tucson (602) 624-3276. 


CALIFORNIA: Irvine (714) 660-1200; 
Sacramento (916) 929-0197; 

San Diego (619) 278-9600; 

Santa Clara (408) 980-9000; 
Torrance (213) 217-7000; 

Woodland Hills (818) 704-7759. 


COLORADO: Aurora (303) 368-8000. 
CONNECTICUT: Wallingford (203) 269-0074. 


FLORIDA: Altamonte i (305) 260-2116; 
Ft. Lauderdale (305) 973-85 
Tampa (813) 286-0420. 


GEORGIA: Norcross (404) 662-7900. 
ILLINOIS: Arlington Heights (312) 640-3000. 


INDIANA: Carmel (317) 573-6400; 
Ft. Wayne (219) 424-5174. 


IOWA: Cedar Rapids (319) 395-9550. 
KANSAS: Overland Park (913) 451-4511. 
MARYLAND: Baltimore (301) 944-8600. 
MASSACHUSETTS: Waltham (617) 895-9100. 


MICHIGAN: Farmington Hills (313) 553-1500; 
Grand Rapids (616) 957-4200. 


MINNESOTA: Eden Prairie (612) 828-9300. 
MISSOURI: St. Louis (314) 569-7600. 

NEW JERSEY: Iselin (201) 750-1050. 

NEW MEXICO: Albuquerque (505) 345-2555. 


NEW YORK: East Syracuse (315) 463-9291; 
Melville (516) 454-6600; Pittsford (716) 385-6770. 
Poughkeepsie (914) 473-2900. 


NORTH CAROLINA: Charlotte (704) 527-0930; 
Raleigh (919) 876-2725. 


OHIO: Beachwood (216) 464-6100; 
Dayton (513) 258-3877. 


OREGON: Beaverton (503) 643-6758. 
PENNSYLVANIA: Blue Bell (215) 825-9500. 
PUERTO RICO: Hato Rey (809) 753-8700. 
TENNESSEE: Johnson City (615) 461-2192. 


TEXAS: Austin (512) 250-6769; 
Houston Sy 778-6592; Richardson (214) 680-5082; 
San Antonio (512) 496-1779. 


UTAH: Murray (801) 266-8972. 

VIRGINIA: Fairfax (703) 849-1400. 
WASHINGTON: Redmond (206) 881-3080. 
WISCONSIN: Brookfield (414) 782-2899. 


CANADA: Nepean, Ontario (613) 726-1970; 
Richmond Hill, Ontario (416) 884-9181; 
St. Laurent, Quebec (514) 336-1860. 


TI Regional 
Technology Centers 


CALIFORNIA: Irvine (714) 660-8140; 
Santa Clara (408) 748-2220; 
Torrance (213) 217-7019. 


COLORADO: Aurora (303) 368-8000. 
GEORGIA: Norcross (404) 662-7945. 
ILLINOIS Arlington Heights (313) 640-2909. 
MASSACHUSETTS: Waltham (617) 895-9196. 
TEXAS: Richardson (214) 680-5066. 
CANADA: Nepean, Ontario (613) 726-1970. 


TI Distributors 


Ti AUTHORIZED DISTRIBUTORS 
Arrow/Kierulff Electronics Group | 
Arrow Canada (Canada) 

Future Electronics (Canada) 
GRS Electronics Co., Inc. 
Hall-Mark Electronics 

Marshall Industries 

Newark Electronics 

Schweber Electronics 

Time Electronics 

Wyle Laboratories 

Zeus Components 


— OBSOLETE PRODUCT ONLY — 
Rochester Electronics, Inc. 
Newburyport, Massachusetts 
(617) 462-9332 


ALABAMA: Arrow/Kierulff (205) 837-6955; 
Hall-Mark (205) 837-8700; Marshall (205) 881-9235; 
Schweber (205) 895-0480. 


ARIZONA: Arrow/Kierulff (602) 437-0750; 
Hall-Mark (602) 437-1200; Marshall (602) 496-0290; 
Schweber (602) 997-4874; Wyle (602) 866-2888. 


CALIFORNIA: Los Angeles/Orange County: 

Arrow/Kierulff (818) 701-7500, (714) 838- ieee 

Hall-Mark (818) 716-7300, (714) 669-4100 

(213) 217-8400; Marshall (818) 407-0101, (818) 459-5500, 

(714) 458-5395; Schweber (818) 999- 4702: 

(714) 863-0200, (213) 320-8090; Wyle (213) 322-9953, 
818) 880-9000, (714) 863-9953; Zeus (714) 921-9000; 
acramento: Hall-Mark (916) 722-8600; 

Marshall (916) 635-9700; Schweber (916) 929-9732; 

Wyle (916) 638-5282; 

San Diego: Arrow/Kierulff (619) 565-4800; 

Hall-Mark (619) 268-1201; Marshall (619) 578-9600; 

Schweber (619) 450-0454; Wyle (619) 565-9171; 

San Francisco Bay Area: Arrow/Kierulff (408) 745-6600, 

Hall-Mark (408) 432-0900; Marshall (408) 942-4600; 

Schweber (408) 432-7171; Wyle (408) 727-2500; 

Zeus (408) 998-5121. - 


COLORADO: Arrow/Kierulff (303) 790-4444; 
Hall-Mark (303) 790-1662; Marshal! (303) 451-8383; 
Schweber (303) 799-0258; Wyle (303) 457-9953. 


CONNETICUT: Arrow/Kieruilff (203) 265-7741; 
Hall-Mark (203) 269-0100; Marshall (203) 265-3822; 
Schweber (203) 748-7080. 


FLORIDA: Ft. Lauderdale: 

Arrow/Kierulff (305) 429-8200; Hall-Mark (305) 971-9280; 
Marshall (305) 977-4880; Schweber (305) 977-7511; 
Orlando: Arrow/Kierulff (305) 725-1480, (305) 682-6923; 
Hall-Mark (305) 855-4020; Marshall (305) 767-8585; 
Schweber (305) 331-7555; Zeus (305) 365-3000; 
Tampa: Hall-Mark (813) 530-4543; 

Marshall (813) 576-1399. 


GEORGIA: Arrow/Kierulff (404) 449-8252: 
Hall-Mark (404) 447-8000; Marshall (404) 923-5750; 
Schweber (404) 449-9170. 


ILLINOIS: Arrow/Kieruiff (312) 250-0500; 
Hall-Mark (312) 860-3800; Marshall (312) 490-0155; 
Newark (312) 784-5100; Schweber (312) 364-3750. 


INDIANA: Indianapolis: Arrow/Kierulff (317) 243-9353; 
Hall-Mark (317) 872-8875; Marshall (317) 297-0483. 


!{OWA: Arrow/Kierulff (819) 395-7230; 
Schweber (319) 373-1417. 


KANSAS: Kansas City: Arrow/Kierulff (913) 541-9542; 
Hall-Mark (913) 888- wee Marshall (913) 492-3121; 
Schweber (913) 492-2922 


MARYLAND: AsicawitGerult (301) 995-6002; 
Hall-Mark (301) 988-9800; Marshall (301) 840-9450; 
Schweber (301) 840-5900; Zeus (301) 997-1118. 
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MASSACHUSETTS Arrow/Kierulff (617) 935-5134; 
Hall-Mark (617) 667-0902; Marshal! (617) 658-0810; 
Schweber (617) 275- 5100, (617) 657-0760; 
Time (617) 532-6200; Zeus (617) 863-8800. 


MICHIGAN: Detroit: Arrow/Kierulff (313) 971-8220; 
Marshall (313) 525-5850; Newark (313) 967-0600; 
Schweber (313) 525-8100; 

Grand Rapids: Arrow/Kierultf (616) 243-0912. 


MINNESOTA: Arrow/Kierulff (612) 830-1800; 
Hall-Mark (612) 941-2600; Marshal! (612) 559-2211; 
Schweber (612) 941-5280. 


MISSOURI: St. Louis: Arrow/Kierulf (314) 567-6888; 
Hall-Mark (314) 291-5350; Marshall (314) 291-4650; 
Schweber (314) 739-0526. 


NEW HAMPSHIRE: Arrow/Kierulff (603) 668-6968; 
Schweber (603) 625-2250. 


NEW JERSEY: Arrow/Kierulff (201) 538-0900, 
(609) 596-8000; GRS Electronics (609) 964-8560; 
Hall-Mark (201) 575-4415, (609) 235-1900; 
Marshall (201) 882-0320, (609) 234-9100; 
Schweber (201) 227-7880. 


NEW MEXICO: Arrow/Kierulff (505) 243-4566. 


NEW YORK: Long Island: 

Arrow/Kierulff (516) 231-1000; Hal!-Mark (516) 737-0600; 
Marshall (516) 273-2424; Schweber (516) 334-7555; 
Zeus (914) 937-7400; 

Rochester: Arrow/Kierulff (716) 427-0300; 

Hall-Mark (716) 244-9290; Marshall (716) 235-7620; 
Schweber (716) 424-2222: 

Syracuse: Marshall (607) 798-1611. 


NORTH CAROLINA: Arrow/Kierulff (919) 876-3132, 
(919) 725-8711; Hall-Mark (919) 872-0712; 
Marshall (919) 878-9882; Schweber (919) 876-0000. 


OHIO: Cleveland: Arrow/Kierulff (216) 248-3990; 
Hali-Mark (216) 349-4632; Marshall (216) 248-1788; 
Schweber (216) 464-2970; 

Columbus: Arrow/Kierulff (614) 436-0928; 
Hall-Mark (614) 888-3313; 

Dayton: Arrow/Kieruilff (513) 435-5563; 

Marshall (513) 898-4480; Schweber (513) 439-1800. 


OKLAHOMA: Arrow/Kierulff (918) 252-7537; 
Schweber (918) 622-8003. 


OREGON: Arrow/Kierulff (503) 645-6456; 
Marshall (503) 644-5050; Wyle (503) 640-6000. 


PENNSYLVANIA: Arrow/Kierulff (412) 856-7000, 
215) 928-1800; GRS Electronics (215) 922-7037; 
chweber (215) 441-0600, (412) 963-6804. 


TEXAS: Austin: Arrow/Kierulff (612) 835-4180; 
Haill-Mark (512) 258-8848; Marshall (512) 837-1991; 
Schweber (512) 239-0088; Wyle (512) 834-9957, 
Dallas: Arrow/Kierulff (214) 380-6464; 

Hall-Mark (214) 553-4300; Marshall (214) 233-5200; 
Schweber (214) 661-5010; Wyle (214) 235-9953; 
Zeus (214) 783-7010; 

Houston: Arrow/Kierulff (713) 530-4700; 

Hall-Mark (713) 781-6100; Marshall (713) 895-9200; 
Schweber (713) 784-3600; Wyle (713) 879-9953. 


UTAH: Arrow/Kierulff (801} 973-6913; 
Hall-Mark (801) 972-1008; Marshall (801) 485-1551; 
Wyle (801) 974-9953. 


WASHINGTON: Arrow/Kierulff (206) 575-4420; 
Marshall (206) 747-9100; Wyle (206) 453-8300. 


WISCONSIN: Arrow/Kierulff (414) 792-0150; 
Hall-Mark (414) 797-7844; Marshall (414) 797-8400; 
Schweber (414) 784-9020. 


CANADA: Calgary: Future (403) 235-5325; 
Edmonton: Future (403) 438-2858; 
Montreal: Arrow Canada (514) 735-5511; 
Future (514) 694-7710; 

Ottawa: Arrow Canada (613) 226-6903; 
Future (613) 820-8313; 

Quebec City: Arrow Canada (418) 687-4231; 
Toronto: Arrow Canada (416) 672-7769, 
Future (416) 638-4771; 

Vancouver: Future (604) 294-1166; 
Winnipeg: Future (204) 339-0554. 


Customer 
Response Center 


TOLL FREE: (800) 232-3200 


OUTSIDE USA: (214) 995-6611 
(8:00 a.m. - 5:00 p.m. CST) 


BU 


| TI Worldwide 
| Sales Offices 


ALABAMA: Huntsville: 500 Wynn Drive, Suite 514, 
Huntsville, AL 35805, (205) 837-7530. 


ARIZONA: Phoenix: 8825 N. 23rd Ave., Phoenix, 
AZ 85021, (602) 995-1007. 


CALIFORNIA: Irvine: 17891 Cartwright Rd., irvine, 
CA 92714, (714) 660-8187; Sacramento: 1900 Point 
West Way, Suite 171, Sacramento, CA 95815, 
(916) 929-1521; San Diego: 4333 View Ridge Ave., 
Suite B., San Diego, CA 92123, (619) 278-9601; 

| Santa Clara: 5353 Betsy Ross Dr., Santa Clara, CA 
95054, (408) 980-9000; Torrance: 690 Knox St., 

| Torrance, CA 90502, (213) 217-7010; 

Woodland Hills: 21220 Erwin St., Woodland Hills, 
CA 91367, (818) 704-7759. 


COLORADO: Aurora: 1400 S. Potomac Ave., 
Suite 101, Aurora, CO 80012, (303) 368-8000. 


CONNECTICUT: Wallingford: 9 Barnes Industrial 
Park Rd., Barnes Industrial Park, Wallingford, 
CT 06492, (203) 269-0074. 


FLORIDA: Ft. Lauderdale: 2765 N.W. 62nd St., 
Ft. Lauderdale, FL 33309, (305) 973-8502; 
Maitland: 2601 Maitland Center Parkway, 
Maitland, FL 32751, (305) 660-4600; 

Tampa: 5010 W. Kennedy Bivd., Suite 101, 

} Tampa, Fl 33609, (813) 870-6420. 


GEORGIA: Norcross: 5515 Spalding Drive, Norcross, 
GA 30092, (404) 662-7900 


| ILLINOIS: Arlington Heights: 515 W. Algonquin, 
Ariington Heights, !L 60005, (312) 640-2925. 


INDIANA: Ft. Wayne: 2020 Inwood Dr., Ft. Wayne, 
IN 46815, (219) 424-5174; 

indianapolis: 2346 S. Lynhurst, Suite J-400, 
Indianapolis, IN 46241, (317) 248-8555. 


IOWA: Cedar Rapids: 373 Collins Rd. NE, Suite 200, 
Cedar Rapids, tA 52402, (319) 395-9550. 


MARYLAND: Baltimore: 1 Rutherford Pl., 
7133 Rutherford Rd., Baltimore, MD 21207, 
(301) 944-8600. 


MASSACHUSETTS: Waltham: 504 Totten Pond Rd., 
Waltham, MA 02154, (617) 895-9100. 


MICHIGAN: Farmington Hills: 33737 W. 12 Mile Rd., 
Farmington Hills, Mt 48018, (313) 553-1500. 


MINNESOTA: Eden Prairie: 11000 W. 78th St., 
Eden Prairie, MN 55344 (612) 828-9300. 


MISSOURI: Kansas City: 8080 Ward Pkwy., Kansas 
City, MO 64114, (816) 523-2500; 

1 St. Louls: 11816 Borman Drive, St. Louis, 

MO 63146, (314) 569-7600. 


NEW JERSEY: Iselin: 485E U.S. Route 1 South, 
Parkway Towers, Iselin, NJ 08830 (201) 750-1050 


NEW MEXICO: Albuquerque: 2820-D Broadbent Pkwy 
NE, Albuquerque, NM 87107, (505) 345-2555. 


NEW YORK: East Syracuse: 6365 Collamer Dr., East 
Syracuse, NY 13057, (315) 463-9291; 

Endicott: 112 Nanticoke Ave., P.O. Box 618, Endicott, 
NY 13760, (607) 754-3900; Melville: 1 Huntington 
Quadrangle, Suite 3C10, P.O. Box 2936, Melville, 

NY 11747, (516) 454-6600; Pittsford: 2851 Clover St., 
Pittsford, NY 14534, (716) 385-6770; 

Poughkeepsie: 385 South Rd., Poughkeepsie, 

F NY 12601, (914) 473-2900. 


NORTH CAROLINA: Charlotte: 8 Wood!awn Green, 
Woodlawn Rd., Charlotte, NC 28210, (704) 527-0930; 
noo 2809 Highwoods Bivd., Suite 100, Raleigh, 
NC 27625, (919) 876-2725. 


OHIO: Beachwood: 23408 Commerce Park Rd., 
Beachwood, OH 44122, (216) 464-6100; 

Dayton: Ne ore Bldg., 4124 Linden Ave., Dayton, 
OH 45432, (513) 258-3877. 


OREGON: Beaverton: 6700 SW 105th St., Suite 110, 
Beaverton, OR 97005, (503) 643-6758. 


PENNSYLVANIA: Ft. Washington: 260 New York Dr., 
Ft. Washington, PA 19034, (215) 643-6450; 
Coraopolis: 420 Rouser Rd., 3 Airport Office Park, 
Coraopolis, PA 15108, (412) 771-8550. 


PUERTO RICO: Hato Rey: Mercanti! Plaza Bidg., 
Suite 505, Hato Rey, PR 00919, (809) 753-8700. 


TEXAS: Austin: P.O. Box 2909, Austin, TX 78769, 
(512) 250-7655; Richardson: 1001 E. Campbell Rd., 
Richardson, TX 75080, 

(214) 680-5082; Houston: 3100 Southwest Frwy., 
Suite 237, Houston, TX 77036, (713) 778-6592; 
San Antonio: 1000 Central Parkway South, 

San Antonio, TX 78232, (512) 496-1779. 


UTAH: Murray: 5201 South Green SE, Suite 200, 
Murray, UT 84107, (801) 266-8972. 


VIRGINIA: Fairfax: 2750 Prosperity, Fairfax, VA 
22031, (703) 849-1400. . 


WASHINGTON: Redmond: 5010 148th NE, Bidg 8, 
Suite 107, Redmond, WA 98052, (206) 881-3080. 


WISCONSIN: Brookfield: 450 N. Sunny Slope, 
Suite 150, Brookfield, WI 53005, (414) 785-7140. 


CANADA: Nepean: 301 Moodie Drive, Mallorn 
Center, Nepean, Ontario, Canada, K2H9C4, 

(613) 726-1970. Richmond Hill: 280 Centre St. E., 
Richmond Hill L4C1B1, Ontario, Canada 

(416) 884-9181; St. Laurent: Ville St. Laurent Quebec, 
9460 Trans Canada Hwy., St. Laurent, Quebec, 
Canada H4S1R7, (514) 335-8392. 


ARGENTINA: Texas Instruments Argentina 
S.A.1.C.F.: Esmeratda 130, 15th Floor, 1035 Buenos 
Aires, Argentina, 1+ 394-3008. 


AUSTRALIA (& NEW ZEALAND): Texas Instruments 
Australia Ltd.: 6-10 Talavera Rd., North Ryde 
(Sydney), New South Wales, Australia 2113, 

2 + 887-1122; 5th Floor, 418 St. Kilda Road, 
Meibourne, Victoria, Australia 3004, 3 + 267-4677; 
171 Philip Highway, Elizabeth, South Australia 5112, 
8 + 255-2066. 


AUSTRIA: Texas Instruments Ges.m.b.H.: 
Industriestrabe 8/16, A-2345 Brunn/Gebirge, 
2236-846210. 


BELGIUM: Texas Instruments N.V. Belgium S.A.: 
Mercure Centre, Raketstraat 100, Rue de la Fusee, 
1130 Brussels, Belgium, 2/720.80.00. 


BRAZIL: Texas Instruments Electronicos do Brasil 
Ltda.: Rua Paes Leme, 524-7 Andar Pinheiros, 05424 
Sao Paulo, Brazil, 0815-6166. 


DENMARK: Texas Instruments A/S, Mairelundvej 
46E, OK-2730 Herlev, Denmark, 2 - 91 74 00. 


FINLAND: Texas Instruments Finland OY: 
Tec euueKaty 19D 00511 Helsinki 51, Finland, (90) 
-3133. 


FRANCE: Texas Instruments France: Headquarters 
and Prod. Plant, BP 05, 06270 Villeneuve-Loubet, 
(93) 20-01-01; Paris Office, BP 67 8-10 Avenue 
Morane-Sautnier, 78141 Velizy-Villacoublay, 

(3) 946-97-12; Lyon Sales Office, L'Oree D’Ecully, 
Batiment B, Chemin de la Forestiere, 69130 Ecully, 
(7) 833-04-40; Strasbourg Sales Office, Le Sebastopol 
3, Quai Kleber, 67055 Strasbourg Cedex, 

88) 22-12-66; Rennes, 23-25 Rue du Puits Mauger, 
5100 Rennes, (99) 31-54-86; Toulouse Sales Office, 
Le Peripole—2, Chemin du Pigeonnier de !a Cepiere, 
31100 Toulouse, (61) 44-18-19; Marseille Sales Office, 
Noilly Paradis—146 Rue Paradis, 13006 Marseille, 

(91) 37-25-30. 
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GERMANY (Fed. Republic of Germany): Texas 
Instruments Deutschland GmbH: Haggertystrasse 1, 
D-8050 Freising, 8161 + 80-4591; Kurfuerstendamm 
195/196, D-1 Berlin 15, 30 + 882-7365; IIl, Hagen 
43/Kibbeistrasse, .19, D-4300 Essen, 201-24250; 
Frankfurter Allee 6-8, D-6236 Eschborm 1, 
06196 + 8070; Hamburgerstrasse 11, D-2000 Hamburg 
76, 040 + 220-1154, Kirchhorsterstrasse 2, D-3000 
Hannover 51, 511 +648021; Maybachstrabe 11, 
D-7302 Ostfiidern 2-Nelingen, 711 + 547001; 
Mixikoring 19, D-2000 Hamburg 60, 40 + 637 + 0061; 
Postfach 1309, Roonstrasse 16, D-5400 Koblenz, 
261 + 35044. 


HONG KONG (+ PEOPLES REPUBLIC OF CHINA): 
Texas Instruments Asia Ltd., 8th Floor, World 
Shipping Ctr., Harbour City, 7 Canton Rd., Kowloon, 
Hong Kong, 3 + 722-1223. 


IRELAND: Texas Instruments (Ireland) Limited: 
erenery Rd., Stillorgan, County Dublin, Eire, 
1311. 


ITALY: Texas instruments Semiconduttori Italia Spa: 
Viale Delile Scienze, 1, 02015 Cittaducale (Rieti), 
Italy, 746 694.1; Via Salaria KM 24 (Palazzo Cosma), 
Monterotondo Scalo (Rome), Italy, 6 + 9003241; Viale 
Europa, 38-44, 20093 Cologno Monzese (Milano), 

2 2532541; Corso Svizzera, 185, 10100 Torino, Italy, 
‘ u Abad: Via J. Barozzi 6, 40100 Bologna, italy, 51 

5851. 


JAPAN: Texas instruments Asia Ltd.: 4F Aoyama 
Fuji Bidg., 6-12, Kita Aoyama 3-Chome, Minato-ku, 
Tokyo, Japan 107, 3-498-2111; Osaka Branch, 5F, 
Nissho Iwai Bidg., 30 Imabashi 3- Chome, 
Higashi-ku, Osaka, Japan 541, 06-204-1881; Nagoya 
Branch, 7F Daini Toyota West Bidg., 10-27, Meieki 
4-Chome, Nakamura-ku Nagoya, Japan 

450, 52-583-8691. 


KOREA: Texas Instruments Supply Co.: 3rd Floor, 
Samon Bldg., SUR COC. Sangnann ne: 
135 Seoul, Korea, 2 + 462-8001. 


MEXICO: Texas Instruments de Mexico S.A.: Mexico 
City, AV Reforma No. 450 — 10th Floor, Mexico, 
D.F., 06600, 5 + 514-3003. 


MIDDLE EAST: Texas Instruments: No. 13, 1st Floor 
Mannai Bidg., Diplomatic Area, P.O. Box 26335, 
Manama Bahrain, Arabian Gulf, 973 + 274681. 


NETHERLANDS: Texas Instruments Holland B.V., 
P.O. Box 12995, (Bullewijk) 1100 CB Amsterdam, 
Zuid-Oost, Holland 20 + 5602911. 


NORWAY: Texas Instruments Norway A/S: PB106, 
Refstad 131, Oslo 1, Norway, (2) 155090. 


PHILIPPINES: Texas Instruments Asia Ltd.: 14th 
Floor, Ba- Lepanto Bis. 8747 Paseo de Roxas, 
Makati, Metro Manila, Philippines, 2 + 8188987. 


PORTUGAL: Texas Instruments Equipamento 
Electronico (Portugal), Lda.: Rua Eng. Frederico 
Ulrich, 2650 Moreira Da Maia, 4470 Maia, Portugal, 
2-948-1003. 


SINGAPORE (+ INDIA, INDONESIA, MALAYSIA, 
THAILAND): Texas Instruments Asia Ltd.: 12 Lorong 
Bakar Batu, Unit 01-02, Kolam Ayer Industrial Estate, 
Republic of Singapore, 747-2255. 


SPAIN: Texas Instruments Espana, S.A.: C/Jose 
Lazaro Galdiano No. 6, Madrid 16, 1/458.14.58. 


SWEDEN: Texas Instruments International Trade 
Corporation (Sverigefilialen): Box 39103, 10054 
Stockholm, Sweden, 8 - 235480. 


SWITZERLAND: Texas instruments, Inc., Reidstrasse 
6, CH-8953 Dietikon (Zuerich) Switzerland, 
1-740 2220. 


TAIWAN: Texas Instruments Supply Co.: Room 903, 
205 Tun Hwan Rd., 71 Sung-Kiang Road, Taipei, 
Taiwan, Republic of China, 2 + 521-9321. 


UNITED KINGDOM: Texas Instruments Limited: 
Manton Lane, Bedford, MK41 7PA, England, 0234 
67466; St. James House, Wellington Road North, 
Stockport, SK4 2RT, England, 61 + 442-7162. 
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